---
title: "Deploy Chatwoot"
description: "Self-hosted customer support inbox: live chat, email, WhatsApp and more"
category: "Other"
url: https://railway.com/deploy/chatwoot-5
---

# Deploy Chatwoot

Self-hosted customer support inbox: live chat, email, WhatsApp and more

**[Deploy Chatwoot on Railway](https://railway.com/template/chatwoot-5)**

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

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Chatwoot https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/chatwoot.png

- **Source:** https://github.com/aalfath/chatwoot-railway-template
- **Health check:** /api
- **Public domain:** Yes

### Redis 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"`

### Postgres

- **Image:** pgvector/pgvector:0.8.7-pg16@sha256:484e838076e04939d27d3e176e91c86eea96236126023be8d3059761122e579f

## Documentation

# Deploy and Host Chatwoot on Railway

Chatwoot is an open-source customer support platform. It gathers conversations from website live chat, email, WhatsApp, Telegram, Facebook, Instagram, SMS and other channels into one shared inbox, where a team can reply, assign conversations, use canned responses and labels, keep contact history and see reports. It is a self-hosted alternative to Intercom and Zendesk.

## About Hosting Chatwoot

Chatwoot is a Ruby on Rails application with a Sidekiq background worker. It needs PostgreSQL with the pgvector extension, Redis for jobs and real-time updates, and persistent storage for uploaded files. This template deploys Chatwoot v4.19.1 from the official image, pinned by version and digest, with Postgres 16 plus pgvector and Railway's Redis. The web server and the worker run in one service and share a volume for attachments. On every start the database is created or migrated automatically. Secrets and connection URLs are generated, so the deploy asks you nothing. Email delivery and channel integrations are optional and configured afterwards.

## Common Use Cases

* A shared inbox for website live chat, email and social messaging channels
* Customer support with assignments, canned responses, labels and reports
* A self-hosted alternative to Intercom or Zendesk that keeps customer data in your own infrastructure

## Dependencies for Chatwoot Hosting

* PostgreSQL 16 with the pgvector extension (`pgvector/pgvector:0.8.7-pg16`)
* Redis (Railway's Redis service)

### Deployment Dependencies

* Chatwoot release notes: https://github.com/chatwoot/chatwoot/releases/tag/v4.19.1
* Self-hosting docs: https://www.chatwoot.com/docs/self-hosted
* Environment variables: https://www.chatwoot.com/docs/self-hosted/configuration/environment-variables
* Template source: https://github.com/aalfath/chatwoot-railway-template

### Implementation Details

**First run:** open the public URL as soon as the deploy finishes and create the administrator account on the installation page. Until you do, anyone who opens the URL can create it. Public sign-up is off; invite your agents from Settings → Agents.

**Email (optional but recommended):** without SMTP, Chatwoot can't send invitations, password resets or email notifications. Add `SMTP_ADDRESS`, `SMTP_PORT`, `SMTP_USERNAME`, `SMTP_PASSWORD`, `SMTP_AUTHENTICATION`, `SMTP_DOMAIN` and `MAILER_SENDER_EMAIL` to the Chatwoot service.

**Channels (optional):** Facebook, Instagram, Slack, Google and Microsoft email and inbound email each need their own variables (`FB_*`, `SLACK_*`, `GOOGLE_OAUTH_*`, `AZURE_APP_*`, `RAILS_INBOUND_EMAIL_*`), listed in Chatwoot's environment variable docs. Website live chat, API, Telegram, Line and WhatsApp Cloud inboxes are set up in the dashboard.

**Custom domain:** after adding one, set `FRONTEND_URL` on the Chatwoot service to `https://YOUR-DOMAIN`.

**File storage:** uploads go to the volume at `/app/storage`. To use S3-compatible storage instead, set `ACTIVE_STORAGE_SERVICE=s3_compatible` and the `STORAGE_*` variables.

**Updates:** the Chatwoot service builds from the template repo. When a new Chatwoot release is pinned there, Railway shows an "update available" notice in your project; migrations run on the next start. Back up Postgres before a major upgrade.

## Why Deploy Chatwoot 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 Chatwoot 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) — Self-hosted virtual tabletop for role-playing games (license required)
- [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/chatwoot-5
