ProudAuthDocs

Meet ProudAuth#

ProudAuth is a self-hosted identity provider written in Go. It handles identities, sign-in, tokens, organizations and access decisions while your applications keep control of their interfaces and business data.

Run the identity server, background worker and PostgreSQL yourself. The worker delivers notifications and webhooks, processes durable jobs and manages key lifecycle. PostgreSQL holds durable state; no message broker or object store is required for the core deployment. Production email requires an SMTP relay.

Choose your starting point#

Your goalStart here
Run a local instanceLocal quickstart
Deploy for real usersProduction installation
Add browser sign-inBackend-for-frontend
Build your own sign-in UIHeadless authentication
Protect an APIResource-server integration
Connect servicesMachine clients
Use a first-party SDKSDK overview

The identity model#

A realm is an identity and issuer boundary. An organization is an application tenant within a realm. A user can belong to several organizations; an ordinary organization-scoped access token carries one organization's context.

An OAuth client represents an application or workload. An API resource defines an audience and its scopes. Roles and permissions describe authority; membership and ownership describe where that authority applies. Your API must check the token's audience and the resource's organization before returning data.

Sign-in is headless#

ProudAuth provides OAuth/OIDC protocol endpoints and an authentication transaction API. There is no built-in hosted browser login or administration console. Supply your own login interface or integrate a backend-for-frontend. The root of the identity API is not a login page.

Know the release status#

The implementation and SDKs are in development. No official version is tagged, and the SDK packages are unpublished. Access to the private checkout or a provided image bundle is required; package-install examples in SDK guides describe the intended package interface, not a claim of registry availability.

The current public hostname is a demonstration installation on one Mac with development email. It is not an availability guarantee or a production service. See compatibility, interoperability and security checks for measured scope.

ProudAuth · Self-hosted identityBuilt 2026-10-13 · 5ff6ddb + local documentation
⌕

Search all guides and the API contract.

↑ ↓ to navigate Enter to open · Esc to close