---
title: "Deploy Tinyauth"
description: "Small OpenID Certified login server, forward-auth proxy and OIDC provider"
category: "Authentication"
url: https://railway.com/deploy/tinyauth
---

# Deploy Tinyauth

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

**[Deploy Tinyauth on Railway](https://railway.com/template/tinyauth)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/tinyauth/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Authentication

## Template content

### Tinyauth https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/tinyauth.png

- **Source:** https://github.com/aalfath/tinyauth-railway-template
- **Health check:** /api/healthz
- **Public domain:** Yes

## Documentation

# 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

* [Tinyauth documentation](https://tinyauth.app/docs/getting-started)
* [Tinyauth v5.2.0 release](https://github.com/tinyauthapp/tinyauth/releases/tag/v5.2.0)
* [Template repository](https://github.com/aalfath/tinyauth-railway-template)

### 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.



## Similar templates

- [Keycloak](https://railway.com/deploy/mSwigX) — [2026-11-04] Keycloak with keywind theme + Apple & Discord providers
- [lua-protector](https://railway.com/deploy/lua-protector) — Test deployed my project first
- [bknd](https://railway.com/deploy/p4nTYL) — Feature-rich yet lightweight backend

Open this page in a browser: https://railway.com/deploy/tinyauth
