How do I deploy OpenCode on Railway?

You can deploy OpenCode 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: open-code-fba3c843, or click "Get template help" for this template for more assistance.

Deploy and Host OpenCode on Railway

OpenCode is an open-source autonomous AI coding agent that can read, write, and edit code with full project awareness. Think of it as an always-available AI developer that works directly in your codebase, handling everything from bug fixes to feature development through natural conversation.

About Hosting OpenCode

Hosting OpenCode on Railway gives you a persistent, always-on AI coding assistant accessible from anywhere via a web browser or terminal. The deployment runs OpenCode's built-in web server, which handles authentication, serves the UI, and proxies requests to OpenCode's backend. With a persistent volume mounted at /data, your workspace, sessions, and state survive deployments and restarts—giving you a true long-running AI agent that remembers context across sessions.

Common Use Cases

24/7 AI Developer — An autonomous coding agent that's always available, no need to start a local process each time
Remote Pair Programming — Access OpenCode from any machine via browser or CLI without local installation
CI/CD Automation — Let OpenCode handle code reviews, refactoring, or automated bug fixes on your infrastructure

Dependencies for OpenCode Hosting

Bun runtime — Required to run OpenCode (installed in the Docker image)
AI API Key — At least one of: Anthropic API key, Minimax API key, or ZhipuAI (GLM) API key

Deployment Dependencies

Railway — Cloud platform for hosting
OpenCode Documentation — Official docs for configuration options

Implementation Details

The template uses OpenCode's built-in web server mode, which handles HTTP serving and authentication without additional proxy code:

# In start.sh
cd /data/workspace
exec bunx opencode web --port "$PORT" --hostname 0.0.0.0

Environment variables control authentication:

OPENCODE_SERVER_PASSWORD — Required password for access
OPENCODE_MODEL — Optional model selection (e.g., anthropic/claude-sonnet-4-5)

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