Shared support inbox and live chat with Chatwoot on Railway
Short answer: Chatwoot is an open-source support platform that puts website live chat, email, WhatsApp, Facebook, Instagram and Telegram into one shared team inbox. Deploy Tracklayer’s Chatwoot v4 template on Railway to run it yourself, then add the chat widget script to your app. The template starts a web service, a separate Sidekiq worker, Postgres with pgvector, Redis and a file bucket. Plan for Hobby or Pro.
Deploy Chatwoot on RailwayWhen a self-hosted support inbox makes sense
Support questions arrive in several places: your site, email, WhatsApp, social accounts. A shared inbox gives your team one queue with assignments and history. Chatwoot suits:
- website live chat and a help center for SaaS and e-commerce teams,
- one inbox for WhatsApp Cloud API, email, Facebook, Instagram and Telegram,
- teams that want an alternative to Intercom or Zendesk with data in their own infrastructure,
- agencies running separate accounts for several clients on one installation.
What the template deploys
| Service | Role |
|---|---|
| chatwoot | Dashboard, API, website widget and real-time updates; runs migrations before each release |
| chatwoot-sidekiq | Background jobs such as sending email, syncing channels and delivering webhooks |
| Postgres | PostgreSQL 16 with the pgvector extension, which Chatwoot’s schema requires |
| Redis | Queues, real-time updates and cache |
| Bucket | Attachments and avatars |
The template uses a separate Sidekiq service rather than running jobs inside the web container, so you can scale each on its own.
Deploy Chatwoot, step by step
These steps use Tracklayer’s Chatwoot v4 template, which runs chatwoot/chatwoot:v4.18.0.
- Deploy the template. There is nothing to enter. Secrets and encryption keys are generated.
- Wait for migrations. The chatwoot service migrates the database in a pre-deploy step. The Sidekiq service waits until no migrations are pending.
- Claim the install. Open the public domain at once and complete the onboarding form. The first person to submit it becomes Super Admin, so do not leave a fresh install waiting.
- Add agents from Settings, then Agents. Sign-up is off by default.
- Add an inbox. Create a website inbox in the dashboard and paste the widget snippet into your app. WhatsApp Cloud API inboxes are set up in the dashboard with your Meta app credentials and need no server variables.
- Configure email. Add
SMTP_ADDRESS,SMTP_PORT,SMTP_USERNAME,SMTP_PASSWORDandMAILER_SENDER_EMAILto both Chatwoot services, then redeploy. See the limits below.
Facebook, Instagram, Slack, Gmail and Outlook channels need app credentials set as optional variables (FB_APP_ID, GOOGLE_OAUTH_CLIENT_ID, AZURE_APP_ID and others listed in the template).
Persistence
Postgres and Redis use volumes. Attachments and avatars live in a Railway Bucket, shared by the web service and every Sidekiq replica, so both services are stateless and can scale with replicas.
Cost
The template’s TEMPLATE.md gives estimates, not measurements, at Railway’s usage prices of 10 USD per GB of RAM per month, 20 USD per vCPU per month and 0.15 USD per GB of volume per month:
| Load | Estimated RAM | Estimated monthly cost |
|---|---|---|
| Idle | about 1.1 GB | about 13 USD |
| Typical, 5 to 20 agents, a few thousand conversations a month | about 1.7 to 2.7 GB | about 25 to 45 USD |
Each extra web or Sidekiq replica adds an estimated 6 to 12 USD. Bucket storage is cents per GB. Hobby is the minimum plan.
Limitations and licence
- Outbound email: Railway only allows outbound SMTP on the Pro plan. On Hobby, invitations, password resets, notification emails and email-channel replies are not delivered.
- Captain AI: it sits under the Chatwoot Enterprise License. See the FAQ before using it in production.
- Not deployed end to end: the template’s open questions say the S3 access to the Bucket and the onboarding flow on an empty database were still to be confirmed on a first deploy. Test an attachment upload and the onboarding form.
- Affiliation: community template, not affiliated with or endorsed by Chatwoot Inc.
Scaling and upgrades
Add replicas to chatwoot for more agents and widget traffic, and to chatwoot-sidekiq for busier channels and webhooks. To upgrade, change the FROM line of the Dockerfile and push.
Other options
Support conversations often sit next to a sales pipeline. See the guide to self-hosting Twenty CRM if you also need a CRM. For the full directory, browse all templates.
FAQ
How do I log in to Chatwoot after deploying?
There is no preset password. When the chatwoot service is healthy, open its domain right away and complete the installation onboarding form. That user becomes Super Admin. Public sign-up is off, so invite agents from Settings, then Agents.
Will email notifications and email replies work?
Only with SMTP configured. Add the SMTP variables and MAILER_SENDER_EMAIL to both Chatwoot services. Railway allows outbound SMTP only on the Pro plan, so on Hobby email notifications and email-channel replies are not delivered. The template's notes say inbound email over IMAP works on every plan.
What does Chatwoot cost to run on Railway?
The template's figures are estimates, not measurements: about 1.1 GB of RAM at idle, roughly 13 USD per month, and roughly 25 to 45 USD per month for a team of 5 to 20 agents with a few thousand conversations a month. Hobby is the minimum plan. Check Railway's current prices.
Is the AI included, and what are the licence terms?
The OpenAI integration for reply suggestions and summaries is in the MIT-licensed core and uses your own key. Captain AI is in Chatwoot's enterprise directory under the Chatwoot Enterprise License, and production use needs a Chatwoot subscription. The template notes a v4.18.0-ce image tag as an MIT-only alternative. This is a community template, not affiliated with Chatwoot Inc.
How do I upgrade Chatwoot?
Read the release notes, change the FROM line in services/chatwoot/Dockerfile of the template repository and push. Migrations run before the new version goes live.