Deploy Tinyauth
Small OpenID Certified login server, forward-auth proxy and OIDC provider
Just deployed
/data
Deploy and Host Tinyauth on Railway
Tinyauth is a small, open-source, OpenID Certified authentication server. It gives your self-hosted apps a login page, works as forward-auth middleware for Traefik, Caddy and Nginx, and acts as an OpenID Connect provider. Users can sign in with local accounts, TOTP, LDAP, or OAuth providers such as GitHub and Google.
About Hosting Tinyauth
Tinyauth is a single Go binary with a web UI. This template runs the official v5.2.0 image, pinned by digest, as one Railway service built from a public GitHub repo, with a volume at /data for the SQLite database, the OIDC signing keys and uploaded resources. On first boot a small start script points Tinyauth at Railway's port and public domain and creates an admin user from a generated password, so there is no default password and nothing to answer at deploy time. Health checks use /api/healthz. OAuth providers, OIDC clients, LDAP and extra users are added later as TINYAUTH_* variables.
Common Use Cases
- Put a login page and optional TOTP in front of self-hosted apps that have no authentication of their own
- Use Tinyauth as the OpenID Connect provider for apps such as Grafana, Portainer or Nextcloud
- Restrict access to a homelab or internal tools to a GitHub, Google or company OAuth whitelist
Dependencies for Tinyauth Hosting
- A Railway volume mounted at
/data(included in the template) - A custom domain, if you want one login shared across several subdomains
Deployment Dependencies
Implementation Details
After deploy, open the public URL and sign in as admin with the ADMIN_PASSWORD shown in the service's Variables tab. Change the password by editing that variable and redeploying.
*.up.railway.app is a public suffix, so on the Railway domain the session cookie covers Tinyauth's own host only. To protect several apps with one login, add a custom domain such as auth.YOUR-DOMAIN and set:
TINYAUTH_APPURL=https://auth.YOUR-DOMAIN
Then point your proxy's forward-auth at https://auth.YOUR-DOMAIN/api/auth/traefik (or /api/auth/caddy, /api/auth/nginx). OIDC clients are added with TINYAUTH_OIDC_CLIENTS_MYAPP_CLIENTID, _CLIENTSECRET and _TRUSTEDREDIRECTURIS. Set TINYAUTH_ANALYTICS_ENABLED=false to turn off upstream's periodic version check-in.
Why Deploy Tinyauth on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Tinyauth on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content

