---
title: "Deploy Chatwoot on StackBlaze"
description: "Deploy Chatwoot with managed Postgres, Valkey, a background worker, platform email, and a public HTTPS URL. Your team answers website chat from one inbox. You pay for compute, not per agent seat."
category: "communication, work, helpdesk"
url: https://www.stackblaze.com/templates/chatwoot
---

# Deploy Chatwoot

Deploy Chatwoot with managed Postgres, Valkey, a background worker, platform email, and a public HTTPS URL. Your team answers website chat from one inbox. You pay for compute, not per agent seat.

**[Deploy Chatwoot on StackBlaze](https://dashboard.stackblaze.com/new/template/chatwoot)**

## This stack

- **Chatwoot**: Web service
- **Worker**: Background worker
- **PostgreSQL**: managed database · TCP:5432
- **Valkey**: managed cache · TCP:6379
- **Email**: platform add-on

## What you get

- **Live chat on your site**: Create a Website inbox and paste its script into your site. Visitors chat from the widget; agents answer from the dashboard.
- **One inbox for the team**: Assign conversations, leave private notes, tag them with labels, and reply faster with canned responses.
- **Live updates, a real worker**: A Sidekiq worker runs next to the web app. New messages appear in the agent view as they arrive, and replies reach the widget straight away.
- **Email included**: Agent invites, password resets, notifications, and replies to visitors who left the page go out through the platform’s email add-on.
- **Your data, your instance**: Conversations and contacts live in your own Postgres. Session and encryption keys are generated at deploy and unique to this instance.
- **Uploads that persist**: Attachments and avatars sit on a 5 GB volume shared by the web app and the worker. Redeploys keep them.

## After you deploy

1. **Create your admin**: Open the public URL. The first start loads the database and takes about two minutes. Then fill in the setup form: name, company, email, and password.
2. **Add a Website inbox**: In Settings → Inboxes, add a Website channel and copy its script into your site. The widget appears on every page.
3. **Invite your team**: Add agents in Settings → Agents. Each one gets an email to set a password, then sees the conversations assigned to them.

## How it is wired

- **Postgres holds the data**: Conversations, contacts, inboxes, and settings live in the attached PostgreSQL with pgvector. Back it up if the history matters.
- **Valkey drives the queue**: Valkey carries the job queue and live updates between the web app and the worker. Both must be running for messages and email to flow.
- **Keep the generated keys**: SECRET_KEY_BASE and the ACTIVE_RECORD_ENCRYPTION_* keys are generated once at deploy. Changing them later signs everyone out and breaks encrypted data.
- **Scale for busy teams**: Each process starts with 768 MB reserved and can use up to 1.5 GB. Raise CPU and RAM, or add web replicas, from the dashboard as volume grows.

## Common questions

### How do I sign in after deploy?

Open the public URL. The first visit shows a one-time setup form that creates your account and its admin. After that, sign in with that email and password.

### How do I put the chat widget on my site?

Create a Website inbox in Settings → Inboxes. Chatwoot gives you a short script; paste it into your site’s HTML and the widget appears.

### Does it send email?

Yes. The template connects the platform email add-on, so agent invites, password resets, notifications, and replies to visitors who left the page are delivered without an SMTP account.

### Can customers reply by email?

Not out of the box. Receiving email needs an inbound mail setup: a domain with mail routing and the MAILER_INBOUND_EMAIL_DOMAIN and RAILS_INBOUND_EMAIL_SERVICE variables, as described in Chatwoot’s docs.

### Where are files stored?

Attachments and avatars are on a 5 GB volume mounted at /app/storage, shared by the web app and the worker. They survive redeploys.

### Can I use my own domain?

Yes. Attach a custom domain from the dashboard and update FRONTEND_URL to match, so links in emails and the widget use it.

### What does it cost?

You pay for the Chatwoot processes, Postgres, Valkey, storage and bandwidth, not per agent or per conversation.


Source: https://github.com/chatwoot/chatwoot