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

# Deploy relaticle | AI-powered CRM

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

**[Deploy relaticle | AI-powered CRM 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 https://relaticle.com/brand/logomark.svg

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

### reverb https://relaticle.com/brand/logomark.svg

- **Image:** ghcr.io/relaticle/relaticle:3.5.6
- **Start command:** `php /var/www/html/artisan reverb:start`
- **Public domain:** Yes

### horizon https://relaticle.com/brand/logomark.svg

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

### scheduler https://relaticle.com/brand/logomark.svg

- **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 CRM built for people and AI-powered work: contacts, companies, opportunities, tasks, notes, custom fields, and an AI chat assistant that can read and update your CRM. This template deploys the full stack in one click.

## About Hosting Relaticle

The template provisions six services:

- **relaticle** — the web app (nginx + php-fpm). Runs migrations and caches on boot, healthcheck on `/up`.
- **horizon** — Laravel Horizon queue worker (chat, mail, imports).
- **scheduler** — Laravel scheduler.
- **reverb** — Laravel Reverb websocket server for realtime chat, on its own public domain.
- **Postgres** and **Redis** with volumes.

All secrets (`APP_KEY`, Reverb credentials) are generated at deploy time and shared to the workers by reference, so every service sees the same values.

The app runs `ghcr.io/tab58/relaticle-railway`, a thin layer over the official image that (a) injects the Reverb client config at boot instead of at build time and (b) trusts Railway's edge proxies so generated URLs are https. Source: https://github.com/tab58/relaticle-railway. Workers and Reverb run the official image.

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

## Common Use Cases

- Self-hosted CRM for a small team that wants data ownership.
- AI-assisted sales pipeline: chat with your CRM using Ollama cloud, OpenAI, or Anthropic models.
- Realtime collaboration on deals and tasks via websockets.

## Dependencies for Relaticle Hosting

- Postgres 18 and Redis 8 (provisioned by the template).
- Optional: an AI provider key, Google OAuth credentials, an SMTP mailbox.

### Deployment Dependencies

- Relaticle: https://github.com/Relaticle/relaticle
- Wrapper image: https://github.com/tab58/relaticle-railway
- Laravel Reverb: https://laravel.com/docs/reverb
- Ollama cloud: https://ollama.com

### After deploy

1. Open the app URL and sign up. Email verification is off by default; set `REQUIRE_EMAIL_VERIFICATION=true` once `MAIL_*` is configured.
2. **AI chat**: set `OLLAMA_API_KEY` + `OLLAMA_MODEL` (Ollama cloud, e.g. `glm-5.3-flash`) or `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` on the `relaticle` service, then redeploy `horizon` (workers copy referenced vars at boot; chat jobs 401 until restarted).
3. **Google login**: create an OAuth client with redirect `https://<your-domain>/auth/callback/google`, set `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET`.
4. **Custom domain**: add it to `relaticle` with target port **8080**, then set `APP_URL` to it and redeploy `reverb`, `horizon` and `scheduler` (they copy `APP_URL` at boot; Reverb rejects websocket connections from any other origin until restarted).

### Upgrade

Bump the image tag on all four app services to the same Relaticle version.


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