VoidAuth

VoidAuth

Official

Docker app from grtgbln's Repository

Overview

VoidAuth is an open-source authentication platform that streamlines user management and access control for self-hosted applications. Centered on OpenID Connect (OIDC) integration, it also offers first class support for Proxy ForwardAuth (ProxyAuth). With a focus on an intuitive end-user and administrator web interface, VoidAuth provides a seamless and professional authentication experience.

Requirements


        Requires a separate Postgres database.
    

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 3000

Target
3000
Default
3000
Value
3000
App URLVariable

URL VoidAuth will be served on. Must start with https://

Target
APP_URL
Default RedirectVariable

The home/landing/app url for your domain. This is where users will be redirected upon accepting an invitation, logout, or clicking the logo when already on the auth home page. Will default to App URL if not provided.

Target
DEFAULT_REDIRECT
Allow RegistrationVariable

Allow new users to self-register themselves without invitation.

Target
SIGNUP
Default
false|true
Registration Requires ApprovalVariable

Whether new users who register themselves require approval by an admin. Setting this to false while SIGNUP is true enables open self-registration; use with caution!

Target
SIGNUP_REQUIRES_APPROVAL
Default
true|false
Enable Email VerificationVariable

If true, users must have an email address and will get a verification email when changing their email address before it can be used. If you are using an email provider, this should be set to true.

Target
EMAIL_VERIFICATION
Default
false|true
App TitleVariable

Title that will show on the web interface, use your own brand/app/title.

Target
APP_TITLE
Default
VoidAuth
Value
VoidAuth
App ColorVariable

Theme color in hex format

Target
APP_COLOR
Default
#906bc7
Value
#906bc7
Contact EmailVariable

The email address used for 'Contact Us' links, which are shown on most end-user pages if this is set.

Target
CONTACT_EMAIL
Database - HostVariable

Host address of the Postgres database.

Target
DB_HOST
Database - PortVariable

Port number of the Postgres database.

Target
DB_PORT
Default
5432
Value
5432
Database - NameVariable

Name of the Postgres database.

Target
DB_NAME
Default
postgres
Value
postgres
Database - UserVariable

Username for the Postgres database.

Target
DB_USER
Default
postgres
Value
postgres
Database - PasswordVariable

Password for the Postgres database.

Target
DB_PASSWORD
Storage Key - PrimaryVariable

Storage encryption key for secret values such as keys and client secrets. Must be at least 32 characters long and should be randomly generated.

Target
STORAGE_KEY
Storage Key - SecondaryVariable

Secondary storage encryption key, used when rotating the primary storage encryption key.

Target
STORAGE_KEY_SECONDARY
SMTP - HostVariable

Hostname of the SMTP server to use for sending emails.

Target
SMTP_HOST
SMTP - PortVariable

Port number of the SMTP server.

Target
SMTP_PORT
Default
587
Value
587
SMTP - UsernameVariable

Username for authenticating with the SMTP server.

Target
SMTP_USER
SMTP - PasswordVariable

Password for authenticating with the SMTP server.

Target
SMTP_PASS
SMTP - From AddressVariable

Email address that emails will be sent from.

Target
SMTP_FROM
SMTP - SecureVariable

Whether to use a secure connection (TLS) when connecting to the SMTP server.

Target
SMTP_SECURE
Default
false|true
App DataPath

Path to data directory

Target
/app/config
Default
/mnt/user/appdata/voidauth/config
Value
/mnt/user/appdata/voidauth/config
Password StrengthVariable

The minimum strength of users passwords, at least 3 is recommended.

Target
PASSWORD_STRENGTH
Default
3|0|1|2|4
Admin EmailsVariable

The minimum duration between admin notification emails. Can be set to values like: '4 hours', '30 minutes', 'weekly', 'daily', etc. If set to 'false', admin notification emails are disabled.

Target
ADMIN_EMAILS
Default
hourly
Value
hourly
Internal App PortVariable

Internal web interface port. Not recommended to change.

Target
APP_PORT
Default
3000
Value
3000

Download Statistics

213,431
Total Downloads
44,869
This Month
29,665
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
voidauth/voidauth:latest
Last Updated2026-05-29
First Seen2025-08-27

Run VoidAuth on Unraid.

VoidAuth is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.