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: 2 days 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 (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-19T03:28:00.000Z (8 days ago)
- Last Synced: 2026-04-19T05:23:56.783Z (8 days ago)
- Topics: authentication, docker, oidc, oidc-provider, proxy-auth, security, selfhosted, sso
- Language: TypeScript
- Homepage: http://voidauth.app
- Size: 9.2 MB
- Stars: 1,949
- Watchers: 7
- Forks: 60
- Open Issues: 44
-
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 a password reset link for the initial admin account in the logs: `docker compose logs voidauth`. Use this account and change the default username 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
### Documentation
Documentation, especially app setup guides, are largely community driven and so contribution is highly encouraged. If you have VoidAuth OIDC setup with an app that is not already listed in the [OIDC App Guides](https://voidauth.app/#/OIDC-Guides) then please consider contributing a guide. When writing documentation follow the existing style of the page and when finished open a PR for review.
### Features and Fixes
Please read the CONTRIBUTING.md to see setup guide. Collaboration in an issue or discussion before opening a PR will improve changes of merging, but is not required.
## 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. For a full list of dependencies, see the `package.json` and `frontend/package.json` files.
## Sponsors
