Deploy Convex Backend

Deploy and Host Convex Backend on Railway

Convex Backend is the open-source reactive database and backend behind Convex, with queries, mutations, actions, file storage and search.

About Hosting Convex Backend

This template runs the official ghcr.io/convex/convex-backend:latest image with SQLite storage on a persistent volume at /convex/data. A random instance secret is generated, and an admin key derived from it is printed in the deploy logs on every start (search for CONVEX ADMIN KEY). Set CONVEX_SELF_HOSTED_URL to your public URL and CONVEX_SELF_HOSTED_ADMIN_KEY to that key in your Convex project, then run npx convex dev. The dashboard is a separate image and is not included.

Common Use Cases

• Self-host the Convex backend for your app
• Real-time reactive queries with TypeScript functions
• Keep data and file storage on infrastructure you control

Dependencies for Convex Backend Hosting

• One service with a volume; nothing else

Deployment Dependencies

• Convex Backend on GitHub
• Docker image

Why Deploy Convex Backend on Railway?

Railway gives you a public HTTPS URL, persistent storage where needed and automatic restarts with no server to maintain. Keep the admin key from the deploy logs private.