Bỏ qua đến nội dung chính
AI Automation
Ảnh bìa bài Chatwoot Docker: tự host trên VPS, gom tin nhắn khách về một chỗ

Chatwoot Docker: tự host trên VPS, gom tin nhắn khách về một chỗ

AIDev TeamTham vấn chuyên môn: Nguyễn Việt Chung

Đăng 12 phút đọc

Mục lục · 21

Mình cài Chatwoot bằng Docker trên một VPS 2 vCPU, 4GB đúng theo tài liệu, ghi thời gian từng bước và đo RAM lúc rảnh, sau khi dùng. Sau đó mình gắn khung chat lên một trang web thử và giả lập cầu nối Zalo bằng hộp thư API để xem tin nhắn đi hai chiều. Bài ghi luôn hai lỗi gặp phải và cách vượt qua.

Chatwoot là phần mềm chăm sóc khách hàng mã nguồn mở: tin nhắn từ khung chat website, email, Telegram, Facebook, WhatsApp đổ về một hộp thư chung, nhiều người cùng trực, có phân công và gắn nhãn. Bản tự host chạy bằng Chatwoot Docker (bộ docker compose chính thức) trên máy chủ của bạn, lịch sử hội thoại nằm trên máy đó.

Ngày 08/11/2026 mình cài Chatwoot 4.19.1 trên một VPS 2 vCPU, 4GB RAM theo đúng hướng dẫn Docker chính thức. Tóm tắt những gì đo được:

  • Từ lúc tải file cấu hình tới lúc trang trả lời: 83 giây, phần lâu nhất là tải image (gói phần mềm đóng sẵn của Docker, 40 giây) và tạo cơ sở dữ liệu (20 giây).

  • Bốn container (rails chạy trang web, sidekiq chạy việc nền như gửi email, gọi webhook, cùng postgres và redis) dùng 920 đến 1.000MiB lúc rảnh, khoảng 1.120MiB sau khi mình tạo 2 hộp thư và 3 cuộc trò chuyện. Cả máy còn trống hơn 2GB.

  • Danh sách kênh có sẵn không có Zalo. Mình thử nối kiểu cầu nối qua hộp thư API: tin của khách vào trong 0,06 giây, trả lời của nhân viên ra tới cầu nối sau 0,3 giây.

  • Lỗi đáng nhớ nhất: Chatwoot từ chối gửi webhook (lời gọi HTTP báo cho chương trình khác biết có tin mới) tới địa chỉ IP nội bộ, mọi tin trong cuộc trò chuyện hiện "Failed to send".

Chatwoot là gì, hợp với ai?

Hãy hình dung một tiệm bán gạo online có 3 người trực: khách hỏi qua khung chat trên web, qua Telegram, qua email. Không có công cụ chung thì mỗi người mở một ứng dụng, không ai biết tin nào đã có người trả lời, người nghỉ việc mang theo lịch sử chat trong tài khoản cá nhân. Chatwoot gom các kênh đó vào một danh sách hội thoại. Mỗi hội thoại có người phụ trách, có nhãn, có ghi chú nội bộ mà khách không thấy.

Bản Community tự host không giới hạn số người trực. Đổi lại, bạn tự lo máy chủ, sao lưu và nâng cấp. Phần việc đó tốn bao nhiêu công thì bài self host là gì bấm giờ một lần sao lưu, xóa sạch rồi khôi phục chính Chatwoot này. Nếu cả tiệm chỉ một người trực một kênh, trả lời thẳng trong ứng dụng của kênh đó vẫn nhanh hơn.

Cần VPS cấu hình bao nhiêu để chạy Chatwoot?

Trang yêu cầu hệ thống ghi 4GB RAM là mức tối thiểu, 4 nhân CPU là mức khuyến nghị, cả hai cho tới 10.000 cuộc trò chuyện mỗi ngày. Tài liệu dặn thêm ít nhất 1GB swap để máy không cạn RAM lúc nâng cấp, và 5 đến 10GB ổ cho PostgreSQL.

Mình chạy trên VPS NAT Small của AIDev Cloud: 2 vCPU, 4GB, 40GB, Ubuntu 24.04. Số nhân thấp hơn mức khuyến nghị, nhưng với vài cuộc trò chuyện mỗi phút thì CPU gần như đứng yên (bốn container cộng lại dưới 2% lúc rảnh). Cách thuê VPS và vào bằng SSH có ở bài VPS là gì và VPS NAT dùng thế nào; số RAM của các việc khác như bot, n8n để so có ở bài chọn cấu hình VPS giá rẻ.

Máy cần có Docker (công cụ chạy phần mềm trong các container cách ly) và Docker Compose (file khai báo nhiều container chạy cùng nhau) trước. Mình cài bằng script get.docker.com, mất 26 giây, ra Docker 29.9.3 và Compose v5.7.0. Tài liệu khuyên dùng Docker từ 20.10.10 và Compose từ v2.14.1 trở lên.

Cài Chatwoot Docker trên VPS thế nào?

Các lệnh dưới lấy từ trang cài bằng Docker của Chatwoot. Mình chạy với quyền root trong thư mục /root/chatwoot.

Bước 1: tải file cấu hình và điền mật khẩu

bash
mkdir -p /root/chatwoot && cd /root/chatwoot
wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example
wget -O docker-compose.yaml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml

Trong .env, bốn dòng phải sửa là SECRET_KEY_BASE, FRONTEND_URL (địa chỉ bạn sẽ mở trên trình duyệt), POSTGRES_PASSWORD và REDIS_PASSWORD. Mật khẩu Postgres phải điền thêm lần nữa trong docker-compose.yaml. Mình sinh chuỗi ngẫu nhiên bằng openssl thay vì tự gõ:

bash
PG=$(openssl rand -hex 16); RD=$(openssl rand -hex 16); SK=$(openssl rand -hex 64)
sed -i "s|^SECRET_KEY_BASE=.*|SECRET_KEY_BASE=$SK|; s|^FRONTEND_URL=.*|FRONTEND_URL=https://vps26361274.onaidev.com|; s|^REDIS_PASSWORD=.*|REDIS_PASSWORD=$RD|; s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$PG|; s|^DEFAULT_LOCALE=.*|DEFAULT_LOCALE=vi|" .env
sed -i "s|      - POSTGRES_PASSWORD=$|      - POSTGRES_PASSWORD=$PG|" docker-compose.yaml

DEFAULT_LOCALE=vi cho giao diện tiếng Việt ngay từ đầu.

Bước 2: mở cổng cho tên miền

File compose gốc chỉ mở cổng 3000 trên 127.0.0.1, tức là chỉ chính VPS gọi được. Tài liệu khuyên đặt Nginx hoặc một proxy khác phía trước để có HTTPS. VPS của mình có sẵn tên miền miễn phí vps26361274.onaidev.com (cổng vào của AIDev Cloud lo phần HTTPS rồi chuyển vào cổng 80 của VPS), nên mình chỉ đổi một dòng:

bash
sed -i "s|'127.0.0.1:3000:3000'|'80:3000'|" docker-compose.yaml

Nếu VPS của bạn có IP riêng, giữ nguyên 127.0.0.1:3000:3000 và cài Nginx kèm chứng chỉ Let's Encrypt như tài liệu hướng dẫn.

Bước 3: tạo cơ sở dữ liệu và chạy

bash
docker compose pull
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
curl -s -o /dev/null -w '%{http_code}\n' localhost/api   # 200 là đã chạy
Log cài Chatwoot trên VPS: tải 2 file ở giây 1, pull xong giây 41, db:chatwoot_prepare xong giây 61 kèm dòng ERROR AI Agents SDK, up -d giây 62, curl localhost/api trả 200 ở giây 83, Chatwoot 4.19.1

Bước

Thời gian (cộng dồn)

Ghi chú

Tải .env và compose, điền mật khẩu

1 giây

docker compose pull

41 giây

image chatwoot 2,73GB, postgres pgvector 621MB, redis 161MB

db:chatwoot_prepare

61 giây

tạo database, chạy migration (tạo bảng)

docker compose up -d

62 giây

4 container chạy

/api trả 200

83 giây

rails cần khoảng 20 giây để sẵn sàng

Ổ đĩa tăng khoảng 3,5GB (7.147MB lên 10.665MB), gần hết là image.

Bước 4: tạo tài khoản quản trị

Mở FRONTEND_URL trên trình duyệt, Chatwoot đưa tới trang tạo tài khoản đầu tiên: tên, tên công ty, email, mật khẩu. Tài khoản này là super admin. Màn tiếp theo hỏi vai trò, ngành, quy mô công ty; bạn chọn rồi bấm Continue là vào hộp thư.

Chatwoot nối được những kênh nào?

Vào Cài đặt, Hộp thư đến, Thêm hộp thư, mình thấy 11 lựa chọn:

Màn chọn kênh khi tạo hộp thư đến trong Chatwoot 4.19.1: Website, Facebook, WhatsApp, SMS, Email, API, Telegram, Line, Instagram, Voice sắp có, WhatsApp Call bản Beta; không có Zalo

Kênh

Trên bản tự host của mình

Cần gì để nối

Website

dùng được, đã thử

dán một đoạn script vào web

API

dùng được, đã thử

tự viết chương trình gọi API

Telegram

có trong danh sách

bot token lấy từ BotFather

Email

có trong danh sách

hộp thư Gmail, Outlook hoặc SMTP/IMAP

WhatsApp, SMS, Line

có trong danh sách

tài khoản bên cung cấp (Meta, Twilio, Bandwidth, Line)

Facebook, Instagram

hiện mờ

phải tạo app Meta và điền khóa vào .env trước

WhatsApp Call

hiện mờ, bản Beta

chưa thử

Voice

"Coming Soon"

chưa dùng được

Zalo

không có

đi qua kênh API và một cầu nối riêng

Mình không có bot Telegram để thử, nên dòng Telegram ghi theo màn hình tạo kênh: Chatwoot chỉ hỏi bot token. Token lấy bằng cách tạo bot với @BotFather trong Telegram. Sau khi dán token, tin nhắn gửi cho bot sẽ đổ về hộp thư; phần này mình chưa thử.

Gắn khung chat Chatwoot lên website

Tạo hộp thư loại Website, Chatwoot cho một đoạn script. Mình dựng một trang thử tên "Tiệm Mây" và dán đoạn này trước thẻ </body>:

html
<script>
  window.chatwootSettings = { locale: 'vi' };
  (function (d, t) {
    var g = d.createElement(t), s = d.getElementsByTagName(t)[0];
    g.src = "https://vps26361274.onaidev.com/packs/js/sdk.js"; g.async = true;
    s.parentNode.insertBefore(g, s);
    g.onload = function () {
      window.chatwootSDK.run({ websiteToken: 'TOKEN_CUA_HOP_THU', baseUrl: 'https://vps26361274.onaidev.com' });
    };
  })(document, "script");
</script>

Bong bóng chat hiện ở góc phải sau 0,3 giây. Mình gửi một câu hỏi như khách, Chatwoot tự hỏi email để báo khi có người trả lời (vì lúc đó chưa có ai bật trạng thái trực). Mình trả lời với vai nhân viên (gọi API của tài khoản, giống gõ trong hộp thư), câu trả lời hiện ngay trong khung chat:

Khung chat Chatwoot trên trang thử Tiệm Mây: khách hỏi gạo ST25 túi 5kg còn hàng không, bot mời để lại email, nhân viên trả lời còn hàng, giao nội thành Hà Nội 1 đến 2 ngày

Chatwoot có nối được Zalo không?

Không có sẵn. Cách làm là tạo hộp thư loại API và viết một chương trình đứng giữa, mình gọi là cầu nối, làm hai việc:

  1. Nhận tin nhắn của khách từ Zalo Official Account (cần OA đã được Zalo duyệt), rồi đẩy vào Chatwoot qua Public API.

  2. Nhận webhook của Chatwoot khi nhân viên trả lời, rồi gửi câu trả lời đó ngược về Zalo.

Mình không có Zalo OA để nối thật, nên mình thử phần phía Chatwoot: một chương trình Python nhỏ trên chính VPS đóng vai cầu nối, nhận webhook và ghi ra file. Phía "tin từ Zalo vào" thì mình gọi Public API bằng curl như cầu nối sẽ làm. Thứ tự gọi là tạo liên hệ (identifier là id người dùng Zalo, kết quả trả về source_id để gán vào SID), mở cuộc trò chuyện (kết quả trả về id để gán vào CV), rồi gửi tin của khách:

bash
PUB=http://localhost/public/api/v1/inboxes/MA_HOP_THU_API
curl -X POST $PUB/contacts -H "Content-Type: application/json" \
  -d '{"identifier":"zalo-uid-4815162342","name":"Chị Lan (Zalo)"}'
curl -X POST $PUB/contacts/$SID/conversations
curl -X POST $PUB/contacts/$SID/conversations/$CV/messages -H "Content-Type: application/json" \
  -d '{"content":"Em ơi chị muốn đổi sang 3 túi nhé, vẫn giao chiều mai."}'

Cầu nối nhận webhook chỉ cần vài dòng:

python
import http.server, json, time
class H(http.server.BaseHTTPRequestHandler):
    def do_POST(s):
        d = json.loads(s.rfile.read(int(s.headers['Content-Length'])))
        with open('/root/webhook.log', 'a') as f:
            f.write(f"{time.strftime('%H:%M:%S')} {d.get('event')} {d.get('message_type')} {d.get('content')!r}\n")
        s.send_response(200); s.end_headers()
http.server.HTTPServer(('0.0.0.0', 3001), H).serve_forever()

Ở cầu nối thật, chỗ ghi file được thay bằng lệnh gọi API của Zalo OA để gửi content cho khách.

Kết quả thử cầu nối: tin vào qua Public API trả 200 trong 0,063 giây, nhân viên trả lời lúc 14:11:18, webhook nhận tin ra sau 0,303 giây với các sự kiện conversation_created, message_created incoming và outgoing

Trong hộp thư, cuộc trò chuyện từ "Zalo" nằm chung danh sách với khung chat web, nhân viên trả lời như mọi kênh khác:

Hộp thư Chatwoot: danh sách có 2 cuộc trò chuyện từ hộp Zalo OA qua API và 1 từ Web Tiệm Mây; bên phải là tin của Chị Lan (Zalo) và câu trả lời của nhân viên đã gửi

Phần Chatwoot chạy đúng như mình mong. Phần khó nằm ở phía Zalo: xin duyệt OA, giữ token truy cập luôn còn hạn, chạy cầu nối 24/7, và sửa khi Zalo đổi API. Mình chưa làm phần này nên không đưa số đo.

Chatwoot Docker chiếm bao nhiêu RAM trên VPS 4GB?

Mình lấy mẫu docker stats khoảng 30 giây một lần. Năm phút đầu sau khi cài, chưa có tài khoản nào, bốn container dùng từ 922 đến khoảng 1.000MiB; cả máy (tính cả Docker và hệ điều hành) dùng 1.383 đến 1.474MB trên 3.848MB. Sau khi dùng thử, số tăng nhẹ:

Biểu đồ RAM Chatwoot 4.19.1 sau khi dùng thử: sidekiq 527,6MiB, rails 447,5MiB, postgres 141,3MiB, redis 4,3MiB, tổng 1.120,7MiB; cả máy dùng 1.579MB trên 3.848MB

sidekiq tăng đều từ 415 lên 475MiB trong 5 phút rảnh đầu tiên rồi đứng ở khoảng 510 đến 528MiB. Như vậy VPS 4GB còn khoảng 2,2GB để chạy thêm việc khác, ví dụ n8n tự host để tự động gắn nhãn hay gửi tin chào. Máy 2GB thì không nên: riêng Chatwoot đã hơn 1GB, chưa kể lúc nâng cấp phải chạy lại migration.

Lỗi mình gặp khi cài Chatwoot

Lỗi 1: dòng ERROR lúc tạo database. Lệnh db:chatwoot_prepare in ra:

text
ERROR -- : Failed to configure AI Agents SDK: We could not find your database: chatwoot_production. Available database configurations can be found in config/database.yml.

Ngay sau đó là dòng Created database 'chatwoot_production' và lệnh kết thúc với mã 0. Dòng ERROR xuất hiện vì phần AI khởi động trước khi database được tạo, nên bỏ qua được. Lệnh docker compose nào cũng in thêm cảnh báo "the attribute version is obsolete" vì file compose gốc còn dòng version: '3'; cảnh báo này cũng vô hại.

Lỗi 2: webhook tới IP nội bộ bị từ chối. Lần đầu mình đặt webhook của hộp API là http://10.12.10.114:8099/zalo, IP nội bộ của VPS. Mọi tin trong cuộc trò chuyện chuyển sang "Failed to send", log sidekiq ghi:

text
WARN -- : [ActiveJob] [WebhookJob] Exception: Invalid webhook URL http://10.12.10.114:8099/zalo : Hostname '10.12.10.114' has no public ip addresses

Trong hộp thư, cuộc trò chuyện đó trông thế này:

Cuộc trò chuyện số 2 trong Chatwoot: tin của khách và tin trả lời đều tô đỏ, ghi Failed to send

Chatwoot chặn webhook tới địa chỉ không phải IP công khai, để không bị lợi dụng gọi vào mạng nội bộ. Mình sửa bằng cách đưa cầu nối ra một địa chỉ công khai: mở cổng NAT 31402 trỏ vào cổng 3001 trên VPS, đặt webhook thành http://hn2.forai.cloud:31402/zalo. Sau đó tin đi hai chiều bình thường. Với cầu nối thật, bạn nên dùng tên miền có HTTPS.

Khi nào không nên tự host Chatwoot?

  • Chỉ một người trực, một kênh. Ứng dụng của chính kênh đó đủ dùng, Chatwoot chỉ thêm việc.

  • Zalo là kênh duy nhất hoặc gần như duy nhất. Bạn sẽ phải nuôi cầu nối riêng, trong khi phần còn lại của Chatwoot ít được dùng.

  • Không ai trong nhóm muốn lo sao lưu và nâng cấp. Mỗi lần nâng cấp phải docker compose pull, chạy lại db:chatwoot_prepare và kiểm tra lại các kênh.

  • VPS dưới 4GB RAM.

Câu hỏi thường gặp

Chatwoot có miễn phí không?

Bản Community tự host là mã nguồn mở, không tính tiền theo số người trực. Bạn trả tiền máy chủ. Một số tính năng như SLA (cam kết mức dịch vụ), SSO (đăng nhập một lần) hay trợ lý AI chỉ có ở bản thương mại.

Cài Chatwoot trên VPS 2GB được không?

Tài liệu đặt 4GB là mức tối thiểu. Trên máy của mình, bốn container đã dùng khoảng 1,1GB sau vài phút dùng thử, cộng hệ điều hành và Docker là khoảng 1,6GB, nên 2GB không còn chỗ cho lúc nâng cấp.

Làm sao cập nhật Chatwoot lên bản mới?

Theo tài liệu: docker compose pull, docker compose up -d, rồi chạy lại docker compose run --rm rails bundle exec rails db:chatwoot_prepare. Bản quá cũ thì nâng qua từng bản trung gian. Nên sao lưu volume Postgres (vùng dữ liệu Docker giữ ngoài container) trước khi nâng.

Có cài Chatwoot cùng Supabase hay n8n trên một VPS được không?

Được nếu đủ RAM. Chatwoot dùng Postgres riêng trong compose của nó; Supabase tự host cũng có Postgres riêng, hai bộ không đụng nhau nhưng cộng RAM lại thì nên chọn VPS 8GB.

Đọc tiếp

Nếu bạn muốn có Chatwoot chạy sẵn mà không tự làm các bước trên, AIDev có dịch vụ cài Chatwoot tự host: cài lên máy chủ của bạn, nối các kênh, và làm cầu nối Zalo như một tích hợp riêng, tính phí riêng.

Cài và đo ngày 08/11/2026 trên VPS NAT Small của AIDev Cloud (2 vCPU Intel Xeon E5-2696 v4, 4GB RAM, Ubuntu 24.04.5 LTS, Docker 29.9.3): Chatwoot 4.19.1, PostgreSQL 16 (pgvector), Redis alpine.

Chuyên mục

AI Automation

Thẻ

Docker

Tham vấn chuyên môn

Nguyễn Việt Chung

Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE

  • Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
  • Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
  • Xây hệ thống AI cho doanh nghiệp tại VietPlatform.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập