Deploy and Host claudeOS on Railway

claudeOS is a persistent, user-configurable Claude Code instance that deploys to Railway with a persistent volume. Fork it, edit config/CLAUDE.md and config/mcp.json, deploy, and connect via claude --remote.

About Hosting claudeOS

claudeOS runs Claude Code headless in a Docker container on Railway with Ubuntu 22.04, Node.js 22, and common dev tools. A persistent volume at /data stores your workspace, config files, memories, and globally installed npm packages across restarts. Config files are seeded from the repo on first boot, then the volume copy becomes authoritative.

Why Deploy claudeOS

• Run a persistent Claude Code instance accessible from anywhere via claude --remote
• Customize system prompts, MCP servers, and permissions through simple config files
• Automatic daily upstream sync via GitHub Actions keeps Claude Code updated
• Persistent storage for workspace, memories, and installed tools

Common Use Cases

• Remote AI coding assistant accessible from any machine or claude.ai
• Always-on Claude Code with persistent project context and memory
• Custom Claude Code setup with MCP integrations like Brave Search or memory servers
• Headless automation workflows with Claude Code

Dependencies for claudeOS

Deployment Dependencies

• A Railway persistent volume mounted at /data
• One of: ANTHROPIC_API_KEY (from console.anthropic.com) or CLAUDE_CODE_AUTH_TOKEN (Claude Max/Pro CLI token)
• The Claude Code CLI on your local machine to connect via claude --remote