---
title: "Deploy relaticle"
description: "The open source CRM built for people and AI-powered work."
category: "Other"
url: https://railway.com/deploy/relaticle
---

# Deploy relaticle

The open source CRM built for people and AI-powered work.

**[Deploy relaticle on Railway](https://railway.com/template/relaticle)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/relaticle/manifest.json

- **Creator:** Tim Bright's Projects
- **Category:** Other

## Template content

### redis-relaticle https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### relaticle

- **Image:** ghcr.io/relaticle/relaticle:3.5.6
- **Health check:** /up
- **Public domain:** Yes

### horizon

- **Image:** ghcr.io/relaticle/relaticle:3.5.6
- **Start command:** `php /var/www/html/artisan horizon`

### scheduler

- **Image:** ghcr.io/relaticle/relaticle:3.5.6
- **Start command:** `php /var/www/html/artisan schedule:work`

### pg-relaticle https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# 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:

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

Or without PHP installed:

```bash
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.

## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/relaticle