How do I deploy Zitadel on Railway?

You can deploy Zitadel on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: zitadel-35a484b7, or click "Get template help" for this template for more assistance.

Deploy and Host Zitadel on Railway

From Zitadel's website:

> ZITADEL is the Identity Infrastructure for Developers.

> We provide a hardened, extensible turnkey solution for all your authentication and authorization needs. Instead of building your own login system, use ZITADEL to accelerate your project with features that work out of the box:

Secure Login: Multi-factor authentication (OTP, U2F, Passkeys) and single sign-on (OIDC, SAML, OAuth2).
B2B Ready: First-class multi-tenancy with branding customization and self-service.
Auditable: Exhaustive audit trail of all events.
Extensible: Execute custom code on events (Actions) to fit your unique workflows.

About Hosting Zitadel

V1 login UI should work right of the box. you can fetch the initial username and password from the env vars in your zitadel instance: FULL_ZITADEL_FIRSTINSTANCE_ORG_HUMAN_USERNAME ZITADEL_FIRSTINSTANCE_ORG_HUMAN_PASSWORD

If you want to use the Login V2 UI, do the following:

Login via the Zitadel instance above
Go to /ui/console/users/create-machine and create a machine / service user
Create a personal access token (PAT) for that user.
Go to /ui/console/instance/members and assign them the Instance Login Client role (aka IAM_LOGIN_CLIENT)

Common Use Cases

Industries requiring auth audit trails (finance, medicine)
Auth for multiple projects
B2B services

Dependencies for Zitadel Hosting

Postgres - Should be preconfigured.

Deployment Dependencies

Relevant links:

Why Deploy Zitadel 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 Zitadel 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.