Deploy and Host OpenConnector on Railway

About Hosting OpenConnector on Railway

OpenConnector runs on Railway as a single Docker image service with the bundled Web Console, HTTP runtime API, MCP endpoint, and SQLite-backed local state. Railway provides managed HTTPS, deploys from the prebuilt Docker Hub image, and mounts persistent storage for runtime data.

Tech Stack

• Node.js 24 Alpine container
• Hono HTTP server
• React/Vite Web Console
• SQLite runtime storage
• MCP and OpenAPI-compatible runtime endpoints
• Railway service domain and persistent volume

Why Deploy OpenConnector on Railway

Railway is a good fit for OpenConnector because the runtime is a single HTTP container that listens on port 3000 and stores all local state under one data directory. The template uses a prebuilt Docker image, avoids source builds, exposes a public HTTPS URL, and persists connection data on a Railway volume.

Common Use Cases

• Browse connector providers and actions from the Web Console.
• Store API keys or OAuth client configuration for self-hosted connector workflows.
• Expose connector actions to apps through HTTP, OpenAPI, or MCP.
• Run a private connector runtime for teams that want control over credentials and storage.

Deployment Notes

The app service uses the Docker image xiaosong233/open-connector-railway:latest built from upstream OpenConnector v1.0.2. It listens on PORT=3000 and binds HOST=0.0.0.0. Runtime state, SQLite data, OAuth config, tokens, and transit files are stored in /app/data, which should be mounted as a Railway volume. OOMOL_CONNECT_ORIGIN should match the Railway public domain so OAuth redirects and generated file URLs use the correct HTTPS origin. Admin and runtime bearer tokens are generated as template secrets; users can view them in Railway variables after deployment.

Dependencies for OpenConnector on Railway

OpenConnector only requires the app container and its persistent data volume for a one-click Railway deployment. No external database or Redis service is required.

Deployment Dependencies