voidauth
Single Sign-On for Your Self-Hosted Universe
What is it?
What it is
VoidAuth is an open-source SSO authentication and user management provider that acts as a gateway for self-hosted applications, offering OpenID Connect, Proxy ForwardAuth, LDAP directory, user/group management, self‑registration, invitations, MFA/passkeys, and a customizable admin panel.
Why it exists
To give self‑hosted service operators a simple, secure, and feature‑rich single sign‑on solution that eliminates the need to implement authentication per app, while providing admin controls, user self‑service, and extensibility.
Who should use it
System administrators managing self-hosted applicationsDevelopers implementing SSO/OIDC in their projectsIT teams requiring customizable authentication solutionsOrganizations needing LDAP integration or proxy authenticationUsers wanting self-hosted password management with passkeys
Who should avoid it
Non-technical users without Docker/Postgres experienceProjects requiring fully managed cloud-based authenticationUsers preferring closed-source or non-AGPL-3.0 licensed solutions
How it works
A quick walkthrough in plain English
How voidauth works
Step 1 of 3
You interact with it
Open voidauth, send a request, or connect it to your stack.
Features
Advantages
- Open-source and free to use
- Self-hosted giving full control over data
- Easy setup with Docker Compose
- Supports modern authentication methods like passkeys
- Highly customizable UI and email templates
- Provides user self-registration and invitation workflows
- Includes LDAP integration for existing directories
- Active community and responsive maintainer
- AGPL-3.0 license ensures openness
Disadvantages
- No third-party security audit reported
- Relies on third-party packages which may introduce risk
- AGPL license may be restrictive for proprietary use
- Requires self-hosting infrastructure and maintenance
- May lack enterprise-grade support or SLAs
- Documentation relies on community contributions
Installation
native
git clone <repo-url> cd <repo> # See README for language-specific setup
FAQ
What is VoidAuth and what does it offer?
VoidAuth is an open‑source Single Sign‑On (SSO) provider that sits in front of self‑hosted applications. It supports OpenID Connect, Proxy ForwardAuth, LDAP, user and group management, self‑registration, invitations, multi‑factor authentication, passkeys, email verification, and encryption‑at‑rest with PostgreSQL or SQLite.
How do I quickly get VoidAuth running with Docker Compose?
Add a service to your compose.yml like the example in the README, mount a config volume, set the required environment variables (APP_URL, STORAGE_KEY, DB_PASSWORD, DB_HOST), and run `docker compose up -d`. Then visit the APP_URL to finish setup.
Which environment variables are mandatory for VoidAuth to start?
APP_URL (the public URL), STORAGE_KEY (encryption key), DB_PASSWORD (matches the Postgres password), and DB_HOST (hostname of the database service). All others are optional and documented in the Getting Started page.
How do I create the initial admin account?
After the first startup, check the logs with `docker compose logs voidauth`. A password reset link for the default admin account will be printed. Use that link to set a secure password, then log in and optionally change the username.
How can I invite new users to my instance?
Log in as an administrator, go to the Invitations page in the Admin Panel, create a new invitation, and send the generated link to the user. The user can then accept the invitation to create their account.
Where can I find instructions for setting up an OIDC client?
Visit the Getting Started page and the OIDC App Guides at https://voidauth.app/#/OIDC-Guides for detailed configuration steps for popular applications.
Featured in Videos
YouTube tutorials and walkthroughs for voidauth
Alternatives
Similar projects ranked by category, topics, and text overlap.
