How do I deploy Pocket ID on Railway?

You can deploy Pocket ID 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: pocket-id-f89ef0a8, or click "Get template help" for this template for more assistance.

Deploy and Host Pocket ID on Railway

Pocket ID is a lightweight, self-hosted OIDC provider that allows users to authenticate with their passkeys. It streamlines the login process by removing traditional passwords in favor of secure WebAuthn standards, providing a centralized and modern identity solution for your personal services and microservices.

About Hosting Pocket ID

Hosting Pocket ID involves deploying a containerized application that integrates a Go backend with a SvelteKit frontend. Because it is designed for simplicity, it uses a local SQLite database for storage, which requires a persistent volume to ensure your users and OIDC clients aren't lost during deployments. On Railway, the hosting process is straightforward: you connect the repository, mount a persistent volume, and configure a public URL. Railway’s automatic SSL termination is particularly beneficial here, as passkey authentication (WebAuthn) strictly requires a secure HTTPS connection to function in modern web browsers.

Common Use Cases

Passwordless Home Server SSO: Use Pocket ID as the central identity provider for your homelab or private tools, allowing you to log in to every service using biometric data or a security key.
Securing Internal Dashboards: Add a passkey-protected OIDC layer in front of internal admin panels or development tools that lack robust native authentication.
Simplified Client Access: Provide a user-friendly login experience for non-technical users to access specific shared services without the friction of managing complex passwords.

Dependencies for Pocket ID Hosting

Persistent Volume: A mount point at /app/backend/data is necessary to store the SQLite database and maintain state across restarts.
HTTPS Environment: A valid SSL certificate and public domain, which are required for the WebAuthn API to initialize in the browser.

Deployment Dependencies

Why Deploy Pocket ID 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 Pocket ID 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.