truster

Truster

Truster is designed to make setting up and operating an OIDC server straightforward:

• Supports Google/GitHub/other OIDC providers, or OTP email login.
• No passwords stored in its database.
• Stores state in SQLite (default), or an external PostgreSQL database for horizontal scaling.
• Policy configuration (like mapping users to groups) can be in a config file, or queried from any PostgreSQL database (even when SQLite is used for state).
• Can be used for Kubernetes control plane auth, simplifying RBAC.
• All HTML page and email templates can be customised without rebuilding the binary.
• Can run on a single VM instance for minimal cost.

Use Truster if you:

• want users to sign in with accounts they already have;
• want to manage email-to-group mapping policies in config files in git, or a database;
• want a small, self-hosted login service; and
• use Kubernetes RBAC to decide what each group can do, or just need an OIDC service for your app.

Official OpenTofu/Terraform modules are available for AWS and Google Cloud, and an OCI Helm chart is published for each release.

See Why Truster? for its intended scope and operational limits.

Try it locally

You can see the complete email-code sign-in flow without a cloud account. You need Go, kubelogin, and three terminals.

Start Mailpit in the first terminal. It captures the demo email instead of sending it for real:

go run github.com/axllent/mailpit@latest

Start Truster in the second terminal:

go run ./cmd/truster serve --demo

Then begin a login:

kubectl oidc-login setup \
  --oidc-issuer-url=http://localhost:8080 \
  --oidc-client-id=kubelogin-local \
  --oidc-pkce-method=S256

Your browser will ask for an email address. Enter any address, open Mailpit at http://localhost:8025, and copy the code from the new message back into the browser. kubelogin will print the identity returned by Truster.

Demo mode is for local evaluation only. It generates temporary signing and email-code secrets and removes its SQLite database when the process exits.

Deploy

Choose a deployment target when you are ready to deploy to a real environment:

• AWS deployment guide
• Google Cloud deployment guide
• Local development and testing guide
• Kubernetes and Helm deployment guide

Documentation

• Getting started
• Configuration reference
• Kubernetes integration
• kubelogin setup
• Troubleshooting
• Example configurations

Development

Install the pinned development tools and Git hooks, then build and validate the project:

make setup
make build
make precommit
make test

make precommit is the fast, read-only check used by the pre-commit hook and CI. Contributor commits must include a Developer Certificate of Origin sign-off; use git commit -s to add it. See DEV.md for local OAuth configuration and end-to-end testing.

License

Truster is licensed under the Apache License, Version 2.0. Copyright The Truster Authors. See the LICENSE file for details.