Deploy and Host relaticle on Railway

Relaticle is an open-source, self-hosted CRM built for people and AI-powered work. It ships with built-in AI chat (Rela) plus an MCP server with 37 tools, so agents like Claude, ChatGPT, Cursor, and Gemini can read and update your CRM. Manage people, companies, opportunities, tasks, and notes with a customizable data model (22 field types), multi-workspace support, role-based permissions, CSV import/export, and a REST API. AGPL-3.0 licensed, 2,000+ automated tests, shipping weekly.

About Hosting relaticle

Relaticle is a Laravel application distributed as a single Docker image (ghcr.io/relaticle/relaticle). This template mirrors the official compose.yml and deploys five services: the web app, a Horizon queue worker, a scheduler, Postgres, and Redis. The web app exposes port 8080 with a /up healthcheck, mounts a volume at /var/www/html/storage/app for uploaded files, and runs database migrations automatically on deploy. Horizon and the scheduler run the same image with custom start commands and share all configuration with the web app through Railway variable references, so the only value you need to supply is APP_KEY. Email defaults to the log mailer; set MAIL_MAILER=smtp and fill in the SMTP variables to send real mail.

Common Use Cases

Self-hosted CRM for sales and customer teams who want full ownership of their data
Agent-native CRM: connect Claude, ChatGPT, or any MCP client to create and update records
Open-source alternative to Attio, HubSpot, Twenty, or EspoCRM

Dependencies for relaticle Hosting

PostgreSQL (provisioned by this template as pg-relaticle)
Redis for cache, sessions, and queues (provisioned by this template as redis-relaticle)
An APP_KEY (Laravel encryption key) supplied at deploy time

Implementation Details

Generate an APP_KEY before deploying:

php -r "echo 'base64:'.base64_encode(random_bytes(32)).PHP_EOL;"

Or without PHP installed:

echo "base64:$(openssl rand -base64 32)"

Service layout:

Service	Image	Start command
relaticle	ghcr.io/relaticle/relaticle	default (web server on 8080)
horizon	ghcr.io/relaticle/relaticle	`php /var/www/html/artisan horizon`
scheduler	ghcr.io/relaticle/relaticle	`php /var/www/html/artisan schedule:work`
pg-relaticle	postgres-ssl	default
redis-relaticle	redis	default

AUTORUN_ENABLED is true on the web app only, so migrations run once per deploy rather than on every container.

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