Deploy Tinyauth

Small OpenID Certified login server, forward-auth proxy and OIDC provider

Deploy Tinyauth

/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

More templates in this category

View Template
Keycloak
[2026-11-04] Keycloak with keywind theme + Apple & Discord providers

beuz
754
View Template
lua-protector
Test deployed my project first

trianaq765-cmd's Project
37
View Template
bknd
Feature-rich yet lightweight backend

10