https://github.com/voidauth/voidauth
Single Sign-On for Your Self-Hosted Universe
https://github.com/voidauth/voidauth
authentication docker oidc oidc-provider proxy-auth security selfhosted sso
Last synced: 1 day ago
JSON representation
Single Sign-On for Your Self-Hosted Universe
- Host: GitHub
- URL: https://github.com/voidauth/voidauth
- Owner: voidauth
- License: agpl-3.0
- Created: 2025-04-18T02:22:16.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-01-22T04:10:55.000Z (5 days ago)
- Last Synced: 2026-01-22T18:30:53.427Z (5 days ago)
- Topics: authentication, docker, oidc, oidc-provider, proxy-auth, security, selfhosted, sso
- Language: TypeScript
- Homepage: http://voidauth.app
- Size: 7.28 MB
- Stars: 1,697
- Watchers: 7
- Forks: 52
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
Single Sign-On for Your Self-Hosted Universe
## What is VoidAuth
VoidAuth is an open-source SSO authentication and user management provider that stands guard in front of your self-hosted applications. It is easy-to-use for admins and end-users, supports nice-to-have features like passkeys, user invitation, self-registration, email support, and more!
Features:
- 🌐 OpenID Connect (OIDC) Provider
- 🔄 Proxy ForwardAuth
- 👤 User and Groups Management
- 📨 User Self-Registration and Invitations
- 🎨 Customizable (Logo, Title, Theme Color, Email Templates)
- 🔑 Multi-factor Authentication, Passkeys, and Passkey-Only Accounts
- 📧 Secure Password Reset with Email Verification
- 🔒 Encryption-At-Rest with Postgres or SQLite Database
### Admin Panel
Administrators can access the Admin Panel in the sidebar menu, where they can manage users and settings.
## Quick Start
Getting started with VoidAuth is straightforward, the recommended approach is to add VoidAuth to a `compose.yml` file:
``` yaml
services:
# ---------------------------------
# Your reverse-proxy service here:
# caddy, traefik, nginx, etc.
# ---------------------------------
voidauth:
image: voidauth/voidauth:latest
restart: unless-stopped
volumes:
- ./voidauth/config:/app/config
environment:
# Required environment variables
# More environment variable options can be found
# on the Getting Started page.
APP_URL: # required, ex. https://auth.example.com
STORAGE_KEY: # required
DB_PASSWORD: # required, same as voidauth-db POSTGRES_PASSWORD
DB_HOST: voidauth-db # required
depends_on:
voidauth-db:
condition: service_healthy
voidauth-db:
image: postgres:18
restart: unless-stopped
environment:
POSTGRES_PASSWORD: # required, same as voidauth DB_PASSWORD
volumes:
- db:/var/lib/postgresql/18/docker
healthcheck:
test: "pg_isready -U postgres -h localhost"
volumes:
db:
```
After creating/updating the compose.yml file and filling in the required environment variables, run `docker compose up -d` and visit your `APP_URL` to get started.
> [!IMPORTANT]
> After VoidAuth starts for the first time, find the initial administrator username and password in the logs: `docker compose logs voidauth`. Use these credentials to log in and change the default username and password or create a separate user for yourself.
> [!TIP]
> Users are created by administrators on the Invitations page by creating a new Invitation, then sending the invitation link.
Please see the [Getting Started](https://voidauth.app/#/Getting-Started) page for setup details and configuration options.
## Support
Issues, Suggestions, and Feature Requests should be added as [Issues](https://github.com/voidauth/voidauth/issues) of the appropriate type. For Help and Support, Q&A, or anything else; open a [Discussion](https://github.com/orgs/voidauth/discussions). This project is actively monitored, I will likely respond quickly.
## Contributing
Please read the CONTRIBUTING.md
## Disclaimer
VoidAuth has not been audited and uses 3rd party packages for much of its functionality, use at your own risk.
## Credits
This project would not be possible without the incredible work of others including but not limited to:
[node-oidc-provider](https://github.com/panva/node-oidc-provider) Handles OIDC Provider functionality
[SimpleWebAuthn](https://github.com/MasterKale/SimpleWebAuthn) Used for webauthn/passkey support
[Angular](https://angular.dev) Frontend web framework
[Knex](https://knexjs.org/) Database connection and query builder
[zxcvbn-ts](https://zxcvbn-ts.github.io/zxcvbn/) Password strength calculator
## Sponsors
[](https://github.com/GitTimeraider)