SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีติดตั้ง Chatwoot บน VPS ด้วย Docker และ Traefik

เรียนรู้วิธีติดตั้ง Chatwoot บน VPS ด้วย Docker Compose และ Traefik พร้อมการตั้งค่า SMTP การสำรองข้อมูล PostgreSQL และขั้นตอนการอัปเกรดเวอร์ชันอย่างปลอดภัยเพื่อใช้งานจริง

สิ่งที่คุณกำลังสร้าง

ในการ self-host Chatwoot บน VPS คุณต้องรันคอนเทนเนอร์ 4 ตัว ได้แก่ กระบวนการ Rails web, Sidekiq background worker, PostgreSQL ที่ติดตั้งส่วนขยาย pgvector และ Redis โดย Chatwoot เป็นซอฟต์แวร์ open source สำหรับงานบริการลูกค้า ซึ่งช่วยให้คุณมีกล่องข้อความทีมแบบรวมศูนย์และ widget แชทบนเว็บไซต์ที่รันอยู่บนเซิร์ฟเวอร์ที่คุณควบคุมเอง การติดตั้งใช้เวลาประมาณ 20 นาที ส่วนงานหลังจากนั้น เช่น การส่งอีเมล, การสำรองข้อมูล, การอัปเกรด และการปรับขนาดทรัพยากร คือปัจจัยที่จะตัดสินว่าระบบของคุณจะยังคงทำงานได้ต่อไปในอีกหนึ่งปีข้างหน้าหรือไม่

คอนเทนเนอร์แต่ละตัวมีหน้าที่เฉพาะตัว Rails ทำหน้าที่ให้บริการแดชบอร์ดสำหรับเจ้าหน้าที่และ API (application programming interface) ของ widget ส่วน Sidekiq ทำหน้าที่ประมวลผลงานที่ใช้เวลานาน เช่น การส่งอีเมล, การดึงข้อมูลจากช่องทางที่เชื่อมต่อ, การรันกฎอัตโนมัติ และการสร้างรายงาน ทางด้าน Postgres จะเก็บข้อมูลบทสนทนา, ข้อมูลติดต่อ, บัญชีเจ้าหน้าที่ และการตั้งค่าทุกอย่างที่คุณปรับเปลี่ยนในแดชบอร์ด ส่วน Redis จะเก็บคิวของ Sidekiq และช่องทาง ActionCable pub/sub ซึ่งทำหน้าที่ผลักข้อความใหม่เข้าสู่แดชบอร์ดที่เปิดค้างไว้โดยไม่ต้องรีโหลดหน้าเว็บ ในกรณีนี้ Redis ไม่ใช่แค่ cache ทั่วไป เพราะหากข้อมูลสูญหายจะส่งผลให้งานที่อยู่ในคิวสูญหายไปด้วย

อิมเมจ Postgres ในไฟล์ compose ต้นฉบับคือ pgvector/pgvector:pg16 แทนที่จะเป็นอิมเมจ postgres มาตรฐาน เนื่องจาก schema ของ Chatwoot จำเป็นต้องเปิดใช้งานส่วนขยาย vector สำหรับฟีเจอร์ AI หากคุณเปลี่ยนไปใช้ Postgres มาตรฐาน การรันฐานข้อมูลครั้งแรกจะหยุดทำงานพร้อมกับข้อผิดพลาด ERROR: extension "vector" is not available เนื่องจากไฟล์ควบคุมของส่วนขยายดังกล่าวไม่มีอยู่ในอิมเมจนั้น ดังนั้นควรใช้อิมเมจที่ทางต้นฉบับจัดเตรียมไว้ให้

คู่มือนี้ตั้งสมมติฐานว่าคุณได้ติดตั้ง Docker และ reverse proxy ไว้บนเซิร์ฟเวอร์เรียบร้อยแล้ว หากยังไม่มี ให้เริ่มต้นที่ Docker Compose บน VPS แล้วจึงกลับมาดำเนินการต่อ

Chatwoot ที่ self-hosted ต้องใช้ VPS ขนาดเท่าไร

ณ เดือน October 2026 หน้าข้อกำหนดของ upstream ระบุว่าขั้นต่ำคือ RAM 4 GB และ CPU 4 cores และรองรับได้สูงสุด 10,000 conversations ต่อวัน โดยประมาณการไว้ที่ RAM 8 GB และ CPU 8 cores สำหรับสูงสุด 20,000 conversations ต่อวัน นอกจากนี้ยังต้องมี swap อย่างน้อย 1 GB โดยให้เหตุผลโดยตรงว่าเพื่อป้องกันไม่ให้เครื่องหน่วยความจำไม่พอระหว่างการอัปเกรด ควรเผื่อพื้นที่ disk 5 GB ถึง 10 GB สำหรับ Postgres ก่อนรวมพื้นที่สำหรับ file uploads

ประเด็นสำคัญคือ VPS ขนาด 2 GB สามารถ boot Chatwoot ได้ และอาจทำงานได้ดีเมื่อมี agents 2 คนกับ inbox ที่มีการใช้งานน้อย แต่จะมีปัญหาหลัก 2 จุด จุดแรกคือ Sidekiq ซึ่ง upstream ระบุว่าใช้หน่วยความจำมากกว่า 1 GB บนเซิร์ฟเวอร์ที่มีงานมาก ดังนั้น email ที่เข้ามาพร้อมกันจำนวนมากหรือ report job อาจทำให้หน่วยความจำของเครื่องไม่พอ ก่อนที่ Rails, Postgres และ Redis จะใช้ทรัพยากรของตนเองด้วยซ้ำ จุดที่สองคือการอัปเกรด เพราะ db:chatwoot_prepare จะ boot กระบวนการ Rails ใหม่เพื่อ apply migrations และการ boot Rails บน image นี้ใช้หน่วยความจำหลายร้อย MB ก่อนที่จะเริ่มทำงานจริง

ระบบจะไม่แสดงคำเตือนที่เข้าใจง่ายก่อนเกิดปัญหา out of memory killer ของ kernel จะส่ง SIGKILL ไปยังกระบวนการที่เลือก ซึ่งโดยทั่วไปคือกระบวนการที่ใช้หน่วยความจำมากที่สุด จากนั้น Docker จะเห็นว่า container หยุดทำงาน และ restart: always จะ start container นั้นใหม่ docker compose ps --all จะแสดง container ที่ restart ซ้ำอย่างต่อเนื่อง หรือค้างอยู่ที่ Exited (137) โดยค่า 137 หมายถึงถูก kill ด้วย signal 9 หากไม่ใส่ --all container ที่หยุดทำงานจะไม่แสดงในรายการเลย อย่างไรก็ตาม exit code 137 เพียงอย่างเดียวไม่ได้ยืนยันว่าสาเหตุคือหน่วยความจำ เพราะ docker kill ก็ส่ง signal เดียวกัน ดังนั้นควรยืนยันด้วย sudo dmesg -T | grep -i "killed process" ซึ่งจะแสดงชื่อกระบวนการที่ kernel เลือก

หากงบประมาณไม่พอสำหรับ 4 GB ให้ใช้เครื่องขนาด 2 GB พร้อม swap 2 GB ได้ แต่ต้องยอมรับว่า response time จะแย่ลงเมื่อมี load สูง swap เป็นเพียง buffer เพื่อป้องกันหน่วยความจำไม่พอ ไม่ใช่การรับประกัน ดังนั้น burst ที่มีขนาดใหญ่เพียงพอยังทำให้ container ถูก kill ได้ ไม่ว่าจะเลือกวิธีใด การกำหนด hard memory ceiling ให้แต่ละ service ก็ยังคุ้มค่า เพราะช่วยป้องกันไม่ให้ worker ใช้ทรัพยากรมากจนทำให้ database หยุดทำงาน ดูรายละเอียดที่ memory limits ใน Docker Compose

File uploads เป็นส่วนที่เพิ่มขึ้นเรื่อย ๆ โดยไม่มีขีดจำกัดหากไม่ได้กำหนดไว้ Screenshot ทุกภาพที่ customer แนบจะถูกเก็บไว้ใน storage volume และยังคงอยู่ที่นั่น ดังนั้นควร monitor docker system df -v แทนการสันนิษฐานว่า database เป็นส่วนที่ใช้พื้นที่ disk จนเต็ม

รับไฟล์ compose และกำหนดเวอร์ชันแบบเจาะจง

mkdir -p ~/chatwoot && cd ~/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
chmod 600 .env

ไฟล์ที่คุณเพิ่งดาวน์โหลดมาระบุค่าเป็น image: chatwoot/chatwoot:latest ให้เปลี่ยนค่านี้ก่อนที่จะดำเนินการอื่นใด

services:
  base: &base
    image: chatwoot/chatwoot:v4.19.1
    env_file: .env
    volumes:
      - storage_data:/app/storage

การใช้ latest หมายความว่า docker compose pull ครั้งถัดไปจะดึงเวอร์ชันล่าสุดที่เผยแพร่ในเช้าวันนั้นมาให้ ซึ่งอาจเป็นเวอร์ชันหลักที่มีการเปลี่ยนแปลงโครงสร้างฐานข้อมูล (migration) ที่คุณไม่ได้อ่านรายละเอียดมาก่อน การทำ migration ของ Chatwoot นั้นในทางปฏิบัติไม่สามารถย้อนกลับได้ ดังนั้นหากเกิดการอัปเกรดโดยไม่ตั้งใจ คุณจะต้องกู้คืนจากข้อมูลสำรองเท่านั้น ไม่สามารถยกเลิกการกระทำได้ ให้กำหนด tag ให้ชัดเจนและเปลี่ยนเวอร์ชันอย่างตั้งใจ v4.19.1 คือ release ปัจจุบัน ณ วันที่ 25 ตุลาคม 2026 และบันทึกประจำรุ่นแนะนำให้ใช้เวอร์ชันนี้เพื่อรับการแก้ไขด้านความปลอดภัยและการปรับปรุงความมั่นคงปลอดภัยล่าสุด โปรดตรวจสอบ หน้า release เพื่อดู tag ที่คุณควรเลือกใช้ในวันนี้ หากคุณกำลังอัปเกรดจาก v4.18.0 หรือเก่ากว่า โปรดอ่านบันทึกของ v4.19.0 ก่อน: Captain V1 ถูกยกเลิกการใช้งานแล้ว และการติดตั้งแบบ self-hosted ที่ใช้คำแนะนำของ V1 จะต้องย้ายไปเป็น V2 ก่อนทำการอัปเกรด บริการใดก็ตามที่มีฐานข้อมูลเป็นของตนเองควรใช้ความระมัดระวังเช่นเดียวกัน ซึ่งเป็นเหตุผลว่าทำไม การทำ self-hosting ตัวติดตามการออกกำลังกาย openGym จึงเริ่มต้นด้วยการกำหนด git tag แม้ว่าจะเป็นแอปพลิเคชันที่มีขนาดเล็กกว่านี้มากก็ตาม

บริการ base เป็น YAML anchor ที่ทั้ง rails และ sidekiq เรียกใช้งานร่วมกัน ดังนั้นการเปลี่ยน tag ในจุดเดียวจะส่งผลต่อทั้งสองส่วน ในระหว่างที่คุณอยู่ในไฟล์ ให้ลบบรรทัด version: '3' ที่ด้านบนออก Compose เวอร์ชันปัจจุบันจะเพิกเฉยต่อบรรทัดนี้และแสดงข้อความ the attribute 'version' is obsolete, it will be ignored ทุกครั้งที่รันคำสั่ง

กรอกข้อมูลในไฟล์ .env

สร้างค่า secret ขึ้นมาก่อน ต้นทางต้องการค่าที่เป็นตัวอักษรและตัวเลขเท่านั้น เนื่องจากอักขระพิเศษอาจเกิดความผิดพลาดเมื่อค่าถูกส่งผ่าน shell หรือตัวแยกวิเคราะห์ YAML

head /dev/urandom | tr -dc A-Za-z0-9 | head -c 63 ; echo ''

จากนั้นกำหนดค่าคีย์เหล่านี้ใน .env

SECRET_KEY_BASE=<the 63 characters you just generated>
FRONTEND_URL=https://support.example.com
FORCE_SSL=true
DEFAULT_LOCALE=en
ENABLE_ACCOUNT_SIGNUP=true

POSTGRES_HOST=postgres
POSTGRES_USERNAME=postgres
POSTGRES_PASSWORD=<long random string>
POSTGRES_DATABASE=chatwoot

REDIS_URL=redis://redis:6379
REDIS_PASSWORD=<a different long random string>

RAILS_ENV=production
INSTALLATION_ENV=docker
ACTIVE_STORAGE_SERVICE=local

POSTGRES_HOST=postgres และ redis://redis:6379 คือชื่อบริการของ Compose ซึ่งจะ resolve กันเองบนเครือข่ายเริ่มต้นของโปรเจกต์ FRONTEND_URL ไม่ใช่แค่ส่วนประกอบตกแต่ง Chatwoot จะนำค่านี้ไปสร้าง URL ของสคริปต์ widget และลิงก์ทุกอย่างในอีเมลขาออก หากค่านี้ผิดพลาด ลิงก์รีเซ็ตรหัสผ่านจะชี้ไปยังโฮสต์ที่ไม่ตอบสนอง

จุดที่ต้องระวังในไฟล์ของต้นทางคือ บริการ postgres ไม่ได้อ่านค่าจาก .env โดยตัวมันเองมีบล็อก environment ที่เว้นค่า POSTGRES_PASSWORD= ไว้ว่างเปล่า ดังนั้นการตั้งรหัสผ่านใน .env เพียงอย่างเดียวจะทำให้ฐานข้อมูลไม่มีรหัสผ่านในขณะที่แอปพลิเคชันมีรหัสผ่าน ให้ชี้บริการไปยังตัวแปรเดียวกันดังนี้:

  postgres:
    image: pgvector/pgvector:pg16
    restart: always
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=chatwoot
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}

Compose จะอ่าน .env จากไดเรกทอรีโปรเจกต์เพื่อใช้แทนที่ ${...} ดังนั้นทั้งสองฝั่งจึงได้รับสตริงเดียวกัน หากตั้งค่าผิดพลาด Rails จะหยุดทำงานพร้อมข้อผิดพลาด PG::ConnectionBad: FATAL: password authentication failed for user "postgres"

พฤติกรรมหนึ่งที่ทำให้หลายคนประหลาดใจคือ อิมเมจ Postgres จะนำค่า POSTGRES_PASSWORD ไปใช้เฉพาะตอนเริ่มต้นไดเรกทอรีข้อมูลที่ว่างเปล่าเท่านั้น การเปลี่ยนค่าในภายหลังจะไม่มีผลใดๆ เพราะ initdb จะไม่ทำงานซ้ำเป็นครั้งที่สอง หากคุณเริ่ม stack ไปแล้ว ให้เปลี่ยนรหัสผ่านภายในฐานข้อมูลโดยตรงแทน

docker compose exec postgres psql -U postgres -c "ALTER USER postgres WITH PASSWORD 'the-new-password';"

ENABLE_ACCOUNT_SIGNUP=true เป็นค่าชั่วคราว มันจะเปิดแบบฟอร์มลงทะเบียนสาธารณะเพื่อให้คุณสร้างบัญชีแรกได้ ให้ตั้งค่าเป็น false และรัน docker compose up -d อีกครั้งทันทีที่สร้างบัญชีเสร็จ มิฉะนั้นใครก็ตามที่พบ URL จะสามารถลงทะเบียนบนระบบ support desk ของคุณได้ หลังจากนั้นตัวแทนจะเข้ามาได้ผ่านการเชิญเท่านั้น และรหัสผ่านของพวกเขาจะอยู่ในแอปนี้แอปเดียว ซึ่งอาจจะไม่มีปัญหาจนกว่าคุณจะเริ่มรันบริการหลายตัวและเบื่อกับการจัดการรายชื่อบัญชีแยกกันในแต่ละที่ ถึงจุดนั้น ผู้ให้บริการยืนยันตัวตนแบบ self-hosted อย่าง Authentik คือสิ่งที่เข้ามาแทนที่การจัดการบัญชีแบบเดิม

ตอนนี้ .env เก็บความลับทั้งหมดของ stack นี้ไว้ในรูปแบบข้อความธรรมดา ดังนั้นควรตั้งค่าสิทธิ์เป็น 600 และไม่นำไฟล์นี้เข้า git วิธีที่ Compose อ่านไฟล์ env และจุดที่ความลับอาจรั่วไหล ครอบคลุมถึงประเด็นสำคัญต่างๆ รวมถึงความแตกต่างระหว่าง env_file และ environment

การติดตั้ง Chatwoot ไว้หลัง Traefik ที่คุณมีอยู่แล้ว

อย่าสร้าง reverse proxy ตัวที่สองสำหรับแอปพลิเคชันเดียว หาก Traefik ทำหน้าที่จัดการ TLS (transport layer security) ให้กับคอนเทนเนอร์อื่นบนเซิร์ฟเวอร์นี้อยู่แล้ว ให้เพิ่ม Chatwoot เข้าไปโดยใช้บล็อก label หากคุณยังไม่มีการตั้งค่าดังกล่าว ให้ดำเนินการตั้งค่าให้เรียบร้อยก่อนโดยดูที่ Traefik หน้าแอป Docker Compose หลายตัว แล้วจึงกลับมาที่นี่

รักษาไฟล์ docker-compose.yaml ของต้นฉบับให้ใกล้เคียงกับค่าเริ่มต้นมากที่สุด เพื่อให้คุณสามารถเปรียบเทียบความแตกต่าง (diff) กับเวอร์ชันใหม่ในอนาคตได้ง่าย และให้ใส่การตั้งค่าที่คุณปรับเปลี่ยนไว้ในไฟล์ override แทน Docker Compose จะรวมไฟล์ docker-compose.override.yaml เข้าด้วยกันโดยอัตโนมัติ และคุณสามารถศึกษา การแยกไฟล์ Compose ออกเป็นหลายไฟล์ เพื่อทำความเข้าใจกฎการรวมไฟล์เหล่านี้

services:
  rails:
    networks:
      - default
      - proxy
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.chatwoot.rule=Host(`support.example.com`)"
      - "traefik.http.routers.chatwoot.entrypoints=websecure"
      - "traefik.http.routers.chatwoot.tls.certresolver=letsencrypt"
      - "traefik.http.services.chatwoot.loadbalancer.server.port=3000"

networks:
  proxy:
    external: true

ใช้ชื่อ entrypoint และ certresolver ของคุณเอง คอนเทนเนอร์ต้องอยู่ใน Docker network เดียวกับ Traefik ซึ่งเป็นสิ่งที่รายการ proxy ทำหน้าที่จัดการ และต้องคงไว้ใน default ด้วยเช่นกัน มิฉะนั้นคอนเทนเนอร์จะสูญเสียการเชื่อมต่อกับ Postgres และ Redis ซึ่งเป็นบรรทัดที่ผู้ใช้งานมักลืมตั้งค่า

ปล่อยบล็อก ports: ไว้ตามเดิม ต้นฉบับกำหนดให้ผูกกับ 127.0.0.1:3000 ซึ่งเป็น loopback เท่านั้น จึงไม่สามารถเข้าถึงได้จากอินเทอร์เน็ต แต่ยังคงมีประโยชน์สำหรับการทดสอบจากภายในเซิร์ฟเวอร์ด้วยคำสั่ง curl -I http://127.0.0.1:3000

แดชบอร์ดของเจ้าหน้าที่จะเปิดการเชื่อมต่อ websocket ค้างไว้ที่ /cable เพื่อรับข้อความแบบเรียลไทม์ Traefik จะส่งต่อการร้องขอ HTTP upgrade โดยอัตโนมัติโดยไม่ต้องตั้งค่าเพิ่มเติม ดังนั้นจึงไม่มีอะไรต้องเพิ่ม หากในอนาคตคุณนำ CDN หรือ proxy อื่นมาวางไว้หน้า Traefik อีกชั้นหนึ่ง โปรดอนุญาตให้มีการใช้งาน websockets ที่นั่นด้วย เพราะหากไม่ได้ตั้งค่า อาการที่พบคือแดชบอร์ดจะโหลดข้อมูลได้ตามปกติ แต่ข้อความใหม่จะปรากฏขึ้นก็ต่อเมื่อกดรีเฟรชหน้าเว็บด้วยตนเองเท่านั้น

การเตรียมฐานข้อมูลและเริ่มการทำงานของ stack

ให้เริ่มการทำงานของบริการข้อมูลก่อน และปล่อยให้ Postgres ทำงานรอบแรกให้เสร็จสิ้น

docker compose up -d postgres redis
docker compose logs postgres | tail -n 5

รอจนกว่า database system is ready to accept connections จะพร้อม จากนั้นจึงสร้าง schema

docker compose run --rm rails bundle exec rails db:chatwoot_prepare

คำสั่งนี้จะสร้างฐานข้อมูลหากยังไม่มีอยู่ จากนั้นจะโหลด schema และข้อมูลตั้งต้น (seed data) ระบบจะแสดงรายการ migration และจบการทำงานอย่างปกติ หากระบบค้างอยู่ที่การแสดง postgres:5432 - no response แสดงว่า entrypoint กำลังรอฐานข้อมูลที่ยังไม่พร้อมรับการเชื่อมต่อ ซึ่งในการรันครั้งแรกมักหมายความว่า initdb กำลังทำงานอยู่ ให้รอ ตรวจสอบ log ของ Postgres แล้วจึงรันคำสั่งอีกครั้ง หากระบบหยุดทำงานที่ส่วนขยาย vector แสดงว่าคุณได้แทนที่ image ของ pgvector ด้วย Postgres รุ่นมาตรฐาน

docker compose up -d
docker compose ps
docker compose logs --tail 30 rails

คอนเทนเนอร์ทั้งสี่ควรแสดงสถานะ Up และ log ของ rails ควรจบด้วยบรรทัดของ Puma ที่ระบุว่ากำลังฟังอยู่ที่ http://0.0.0.0:3000 จากนั้นให้ตรวจสอบ public path:

curl -sI https://support.example.com | head -n 1

HTTP/2 200 หมายความว่าห่วงโซ่การทำงานทั้งหมดใช้งานได้ปกติ หากได้รับ 404 จาก Traefik แสดงว่ากฎของ router ไม่ตรงกัน ซึ่งมักเกิดจากการพิมพ์ชื่อ host ผิด หากได้รับ 502 แสดงว่า Traefik พบ router แล้วแต่ไม่สามารถเชื่อมต่อไปยังคอนเทนเนอร์ได้ ซึ่งมักเกิดจากการขาด network proxy หรือค่า loadbalancer.server.port ไม่ใช่ 3000

เปิด URL สร้างบัญชีของคุณที่ /app/auth/signup จากนั้นตั้งค่า ENABLE_ACCOUNT_SIGNUP=false และรัน docker compose up -d เพื่อปิดฟอร์มดังกล่าว

เหตุใดการรีเซ็ตรหัสผ่านและการสนทนาผ่านอีเมลจึงล้มเหลวหากไม่มี SMTP

Chatwoot ที่ไม่มีการตั้งค่า SMTP (Simple Mail Transfer Protocol) จะเป็นระบบสนับสนุนที่ไม่สามารถส่งอีเมลได้ ซึ่งส่งผลกระทบมากกว่าแค่เรื่องการแจ้งเตือน การรีเซ็ตรหัสผ่านจะใช้งานไม่ได้ ทำให้ผู้ดูแลระบบที่ถูกล็อกออกจากระบบไม่สามารถกลับเข้ามาได้อีก การเชิญเจ้าหน้าที่เข้าใช้งานก็จะทำไม่ได้เช่นกันเนื่องจากการเชิญต้องส่งผ่านอีเมล การตอบกลับลูกค้าในการสนทนาผ่านอีเมลก็จะหยุดทำงาน ทำให้การสนทนาสื่อสารได้เพียงทางเดียว นี่คือขั้นตอนที่ผู้คนมักข้ามไปและมาพบปัญหาในภายหลังในช่วงเวลาที่วิกฤตที่สุด

กลไกของเรื่องนี้ชัดเจน เมื่อไม่มีการตั้งค่า SMTP_ADDRESS ระบบ Chatwoot จะเปลี่ยนไปใช้การส่งผ่าน sendmail ของ ActionMailer เอกสารต้นทางระบุว่านี่คือการตั้งค่า Postfix ซึ่งเป็นค่าเริ่มต้นตั้งแต่ v2.12.0 และคำแนะนำในการติดตั้งจะทำการติดตั้ง Postfix ลงบนเซิร์ฟเวอร์ด้วย sudo apt install -y postfix แต่การตั้งค่าผ่าน Docker นี้ไม่ได้ดำเนินการดังกล่าว จึงไม่มีเมลเซิร์ฟเวอร์ที่ถูกกำหนดค่าไว้เพื่อรับช่วงต่อในการส่งเมล อีเมลจะถูกส่งออกจากงานเบื้องหลัง (background job) ดังนั้นข้อผิดพลาดใดๆ ที่เกิดขึ้นจากการส่งจะไปปรากฏอยู่ใน log ของ Sidekiq และไม่ปรากฏใน log ของ Rails ในขณะที่ผู้ใช้ที่คลิก "ลืมรหัสผ่าน" จะเห็นข้อความยืนยันที่ดูปกติ แต่กลับไม่ได้รับอีเมลใดๆ

MAILER_SENDER_EMAIL=Support <support@example.com>
SMTP_DOMAIN=example.com
SMTP_ADDRESS=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=support@example.com
SMTP_PASSWORD=<the relay password>
SMTP_AUTHENTICATION=plain
SMTP_ENABLE_STARTTLS_AUTO=true

ให้ใช้พอร์ต 587 ร่วมกับ STARTTLS ซึ่งจะเปิดการเชื่อมต่อด้วยข้อความธรรมดาแล้วยกระดับเป็นแบบเข้ารหัสก่อนการยืนยันตัวตน ผู้ให้บริการ VPS หลายรายบล็อกพอร์ต 25 ขาออกโดยค่าเริ่มต้นเพื่อจำกัดสแปม ณ วันที่ 8 พฤศจิกายน 2026 ผู้ให้บริการอย่าง Hetzner จะบล็อกพอร์ต 25 และ 465 โดยค่าเริ่มต้นบน cloud server โดยมีการบังคับใช้การบล็อกต่อบัญชี และ Vultr จะบล็อกพอร์ต 25 บน Compute Instances ที่สร้างใหม่ทั้งหมด ทั้งสองรายจะพิจารณาคำขอปลดบล็อกเป็นรายกรณีไป โดย Hetzner กำหนดให้ต้องเป็นลูกค้ามาแล้วหนึ่งเดือนและชำระใบแจ้งหนี้แรกก่อนจึงจะสามารถส่งคำขอปลดล็อกได้ ทั้งสองรายไม่ได้บล็อกพอร์ต 587 ดังนั้นการใช้ relay บนพอร์ต 587 จึงใช้งานได้ตั้งแต่การบูตครั้งแรกโดยไม่ต้องส่งตั๋วหรือรอคอย SMTP_DOMAIN คือโดเมนที่เซิร์ฟเวอร์ของคุณประกาศระหว่างการสนทนา SMTP และ relay บางแห่งอาจปฏิเสธหากข้อมูลไม่ตรงกัน

ใช้การตั้งค่าและตรวจสอบ worker:

docker compose up -d rails sidekiq
docker compose logs -f sidekiq

ทดสอบการรีเซ็ตรหัสผ่านจากหน้าล็อกอิน หากการส่งทำงานปกติ งาน mailer จะเสร็จสิ้นตามปกติใน log ของ Sidekiq หากล้มเหลวจะแสดงคลาสของข้อยกเว้น จากนั้น Sidekiq จะพยายามส่งใหม่โดยเพิ่มระยะเวลาถอยกลับ (backoff) ซึ่งเป็นเหตุผลว่าทำไม relay ที่มีปัญหาจึงสร้างข้อผิดพลาดเดิมซ้ำๆ ทุกสองสามนาทีเป็นเวลาหลายชั่วโมง

การปฏิเสธการเชื่อมต่อที่พบบ่อยมีสองกรณี และไม่มีกรณีใดที่เป็นบั๊กของ Chatwoot 535 Authentication failed หมายถึงการยืนยันตัวตนล้มเหลว ให้ตรวจสอบข้อมูลประจำตัว ตรวจสอบว่าเปิดใช้งานการยืนยันตัวตน SMTP แล้วหรือไม่ และมีนโยบายการเข้าถึง (access policy) บล็อกไว้หรือไม่ ข้อมูลประจำตัวที่ถูกต้องเพียงอย่างเดียวไม่สามารถรับประกันได้ว่าจะไม่เกิดข้อผิดพลาดนี้ ผู้ให้บริการบางรายกำหนดให้ใช้รหัสผ่านเฉพาะแอป (application password) แทนรหัสผ่านบัญชีปกติ 550 Sender address rejected หมายถึงเซิร์ฟเวอร์ปฏิเสธที่อยู่อีเมลผู้ส่ง ให้อ่านการตอบกลับทั้งหมดก่อนที่จะเปลี่ยน MAILER_SENDER_EMAIL สิทธิ์ของผู้ส่งหรือการยืนยันตัวตนเป็นสาเหตุหนึ่ง แต่ 550 5.7.27 Sender address rejected: Domain does not accept mail อาจชี้ไปที่โดเมนของผู้ส่งที่มีระเบียน MX เป็นค่าว่าง (null MX record)

การรับอีเมลเข้าสู่การสนทนาเป็นอีกงานหนึ่ง สำหรับการส่งต่อผ่านช่องทางรับข้อมูลของ Chatwoot จำเป็นต้องมี MAILER_INBOUND_EMAIL_DOMAIN และ RAILS_INBOUND_EMAIL_SERVICE รวมถึงเมลเซิร์ฟเวอร์ที่ส่งข้อความขาเข้าให้กับ Chatwoot คุณยังสามารถเชื่อมต่อกล่องจดหมายผ่าน IMAP รวมถึง Google หรือ Microsoft OAuth ได้โดยไม่ต้องตั้งค่าเส้นทางการส่งต่อดังกล่าว การเช่า relay เป็นวิธีที่รวดเร็วที่สุด หากคุณต้องการดูแลเส้นทางอีเมลทั้งหมดด้วยตนเอง การรันเมลเซิร์ฟเวอร์ของคุณเองด้วย Mailcow จะครอบคลุมถึงสิ่งที่ต้องดำเนินการจริงในกระบวนการนี้

สิ่งที่ต้องสำรองข้อมูลและวิธีตรวจสอบว่าการกู้คืนใช้งานได้จริง

การสำรองข้อมูล Chatwoot ประกอบด้วยสี่ส่วน หากขาดส่วนใดส่วนหนึ่งไป การกู้คืนจะกลายเป็นการสร้างระบบใหม่แทน

  • ฐานข้อมูล Postgres ซึ่งเก็บข้อมูลบทสนทนา รายชื่อผู้ติดต่อ บัญชีเจ้าหน้าที่ และการตั้งค่าทั้งหมด
  • วอลลุ่ม storage_data เนื่องจาก ACTIVE_STORAGE_SERVICE=local จะเขียนไฟล์ที่อัปโหลดลงในดิสก์และเก็บเพียงอ้างอิงไว้ใน Postgres เท่านั้น
  • ไฟล์ .env เนื่องจากเป็นที่เก็บ SECRET_KEY_BASE และกุญแจ ACTIVE_RECORD_ENCRYPTION_*
  • ไฟล์ compose เนื่องจากเป็นตัวบันทึก image tag ที่ตรงกับ schema ของฐานข้อมูลของคุณ

หากกู้คืนเฉพาะฐานข้อมูล บทสนทนาทั้งหมดจะกลับมาพร้อมกับไฟล์แนบที่ใช้งานไม่ได้ เนื่องจากแถวข้อมูลชี้ไปยังไฟล์ที่ไม่มีอยู่บนดิสก์แล้ว

cd ~/chatwoot
docker compose exec -T postgres pg_dump -U postgres -Fc chatwoot > db-$(date +%F).dump

-T มีความสำคัญ หากไม่มีแฟล็กนี้ Compose จะจัดสรร pseudo terminal ซึ่งจะเขียนทับไบต์ขึ้นบรรทัดใหม่ในสตรีม ทำให้ได้ไฟล์ดัมพ์ที่ pg_restore ปฏิเสธการใช้งาน -Fc คือรูปแบบเฉพาะที่ช่วยบีบอัดและทำให้ pg_restore สามารถเลือกกู้คืนข้อมูลบางส่วนได้

docker run --rm -v chatwoot_storage_data:/data:ro -v "$PWD":/backup alpine \
  tar czf /backup/storage-$(date +%F).tgz -C /data .

ชื่อวอลลุ่มคือชื่อไดเรกทอรีโปรเจกต์ของคุณบวกกับ _storage_data ให้ยืนยันชื่อด้วย docker volume ls | grep storage_data ก่อนที่จะเชื่อมั่นในคำสั่งนั้น เพราะ Docker จะสร้างวอลลุ่มเปล่าขึ้นมาแทนที่จะแจ้งเตือนความผิดพลาดหากคุณระบุชื่อที่ไม่มีอยู่จริง คุณจะได้ไฟล์เก็บถาวรที่สมบูรณ์แต่ว่างเปล่าโดยไม่มีข้อผิดพลาดใดๆ ให้ตรวจสอบขนาดไฟล์หลังจากนั้นด้วย ls -lh storage-*.tgz

ไฟล์ทั้งสองตอนนี้ยังคงอยู่บนดิสก์เดียวกับสิ่งที่มันปกป้อง ซึ่งไม่ได้ช่วยป้องกันความเสียหายใดๆ ให้ย้ายไฟล์ออกจากเซิร์ฟเวอร์และเข้ารหัสไว้ เนื่องจากไฟล์ดัมพ์ฐานข้อมูลมีข้อความของลูกค้าทุกคนในรูปแบบข้อความธรรมดา การสำรองข้อมูลนอกสถานที่แบบเข้ารหัสด้วย restic ครอบคลุมเรื่องการตั้งเวลาและการเก็บรักษาข้อมูล

การซ้อมกู้คืนข้อมูล ให้ทำก่อนที่จะมีความจำเป็นต้องใช้จริง

ให้กู้คืนลงบน VPS เครื่องที่สอง ไม่ใช่เครื่องที่ใช้งานจริง คัดลอก .env, ไฟล์ compose และไฟล์เก็บถาวรทั้งสองชุดไปที่เครื่องนั้น จากนั้นรันคำสั่ง:

docker compose up -d postgres
docker compose exec -T postgres pg_restore -U postgres -d chatwoot --clean --if-exists < db-2026-08-10.dump
docker run --rm -v chatwoot_storage_data:/data -v "$PWD":/backup alpine \
  sh -c 'rm -rf /data/* && tar xzf /backup/storage-2026-08-10.tgz -C /data'
docker compose up -d

--clean --if-exists จะลบออบเจกต์ที่มีอยู่ออกก่อนโหลดข้อมูลใหม่ ดังนั้นให้ใช้กับฐานข้อมูลที่คุณยอมรับการสูญเสียได้เท่านั้น จากนั้นให้ลงชื่อเข้าใช้และเปิดบทสนทนาที่มีไฟล์แนบ หากรายการข้อความโหลดขึ้นและดาวน์โหลดไฟล์ได้ แสดงว่าการสำรองข้อมูลนั้นใช้งานได้จริง

การกู้คืนด้วย SECRET_KEY_BASE ที่ต่างไปจะทำให้ session cookie ทั้งหมดเป็นโมฆะ ส่งผลให้ทุกคนถูกออกจากระบบ การกู้คืนด้วยกุญแจ ACTIVE_RECORD_ENCRYPTION_* ที่ต่างไปจะเลวร้ายยิ่งกว่า: Chatwoot จะไม่สามารถถอดรหัสคอลัมน์ที่เก็บข้อมูลรับรองของช่องทางสื่อสารได้และจะแสดงข้อผิดพลาด ActiveRecord::Encryption::Errors::Decryption นี่คือเหตุผลว่าทำไม .env จึงอยู่ในรายการสำรองข้อมูล

วิธีการอัปเกรด Chatwoot ไปยัง tag ใหม่

ลำดับขั้นตอนมีความสำคัญมากกว่าตัวคำสั่ง

  1. อ่านบันทึกประจำรุ่น (release notes) ระหว่าง tag ปัจจุบันของคุณกับ tag เป้าหมาย เพื่อตรวจสอบว่ามีขั้นตอนที่ต้องทำด้วยตนเองหรือไม่
  2. สำรองข้อมูลฐานข้อมูล (database dump) และไฟล์เก็บข้อมูล (storage archive) ชุดใหม่ พร้อมตรวจสอบว่าขนาดไฟล์ทั้งสองดูเป็นปกติ
  3. แก้ไข image tag ของบริการ base ในไฟล์ docker-compose.yaml
  4. ดึง image ใหม่, หยุด stack, รันการย้ายข้อมูล (migrations) แล้วจึงเริ่มระบบใหม่
docker compose pull
docker compose down
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
docker compose images

ต้องดึง image ใหม่ก่อนเริ่มการย้ายข้อมูล เพราะการย้ายข้อมูลต้องรันจาก image ใหม่เท่านั้น เนื่องจาก image เก่าไม่มีไฟล์สำหรับการย้ายข้อมูลชุดใหม่ ให้หยุด stack ก่อนเริ่มการย้ายข้อมูล เพราะโค้ดเก่ากับ schema ใหม่ไม่สอดคล้องกัน กระบวนการ Rails รุ่นเก่าที่ยังทำงานอยู่อาจทำให้เกิดข้อผิดพลาดหรือเขียนข้อมูลลงในแถวที่ schema ใหม่ไม่รองรับ การหยุดบริการยังช่วยคืนหน่วยความจำที่จำเป็นสำหรับการย้ายข้อมูล ซึ่งเป็นเหตุผลหลักที่ผู้พัฒนาต้นทางแนะนำให้ใช้ swap

docker compose images จะแสดง tag ที่แต่ละ container กำลังใช้งานจริง ซึ่งช่วยตรวจสอบกรณีที่คุณแก้ไข tag แล้วลืมดึง image ใหม่

ระยะห่างของการอัปเกรดขึ้นอยู่กับว่าการติดตั้งของคุณเก่าเพียงใด สำหรับการติดตั้งที่ล้าหลังไปเพียงหนึ่งหรือสองรุ่น ให้ตรวจสอบบันทึกประจำรุ่นระหว่าง tag ของคุณกับเป้าหมาย ตั้งค่า tag เป้าหมาย แล้วทำตามขั้นตอนข้างต้นเพียงครั้งเดียว เฉพาะในกรณีที่การติดตั้งของคุณเก่ามากเท่านั้นที่คู่มือ Docker ของผู้พัฒนาต้นทางจะแนะนำให้อัปเกรดแบบไล่ระดับผ่าน image tag ระหว่างกลางแทนการข้ามไปยัง image ล่าสุดโดยตรง ในกรณีนั้น ให้ทำขั้นตอนการเปลี่ยน tag, ดึง image และเตรียมระบบซ้ำสำหรับแต่ละ tag ระหว่างกลาง เพราะผู้พัฒนาต้นทางกำหนดให้รัน db:chatwoot_prepare หลังการอัปเกรดแต่ละครั้ง

หาก Rails เริ่มทำงานก่อนที่การย้ายข้อมูลจะเสร็จสิ้น ระบบจะปฏิเสธการให้บริการและบันทึก ActiveRecord::PendingMigrationError: Migrations are pending ลงใน log หากตั้งค่า restart: always ไว้ container จะวนลูปการทำงาน ทำให้ docker compose ps แสดงค่า uptime ที่รีเซ็ตใหม่ทุกสองสามวินาที ให้รันขั้นตอนการเตรียมระบบแล้วสถานะจะกลับมาเป็นปกติ

การย้อนกลับ (rollback) หมายถึงการเปลี่ยนกลับไปใช้ tag เดิมและกู้คืนข้อมูลจากไฟล์สำรอง ไม่มีเส้นทางการย้ายข้อมูลย้อนกลับที่เชื่อถือได้ ซึ่งเป็นเหตุผลว่าทำไมจึงต้องมีขั้นตอนที่ 2

โหมดความล้มเหลวและข้อความที่จะแสดง

502 Bad Gateway จาก Traefik router จับคู่คำขอได้ แต่ backend ไม่ตอบสนอง ตรวจสอบว่า docker compose ps แสดง rails เป็น Up จากนั้นเรียกใช้ docker network inspect proxy และยืนยันว่า container ของ rails ปรากฏอยู่ในรายการ container ของระบบ container ที่ไม่ได้เชื่อมต่อจะไม่ปรากฏให้ Traefik เห็น ดังนั้นคำขอจึงจับคู่กับ router ได้ แต่ไม่สามารถส่งต่อไปที่ใดได้

Dashboard โหลดได้ แต่ข้อความใหม่จะแสดงหลัง refresh เท่านั้น websocket ไปยัง /cable เชื่อมต่อไม่สำเร็จ หรือ FRONTEND_URL ไม่ตรงกับ address ในแถบที่อยู่ของเบราว์เซอร์ หากค่าไม่ตรงกัน หน้าเว็บจะพยายามเปิด websocket ไปยัง origin อื่น ซึ่งเบราว์เซอร์จะบล็อก

FATAL: password authentication failed for user "postgres" รหัสผ่านใน .env ไม่ตรงกับรหัสผ่านที่ถูกบันทึกไว้ใน Postgres data volume แก้ไขด้วย ALTER USER ภายใน container ที่กำลังทำงานอยู่ เนื่องจากการแก้ไข .env อีกครั้งจะไม่เปลี่ยนฐานข้อมูลที่ initialize แล้ว

NOAUTH Authentication required. Redis ทำงานโดยใช้ --requirepass แต่แอปพลิเคชันเชื่อมต่อโดยไม่ใช้รหัสผ่าน ดังนั้น REDIS_PASSWORD จึงหายไปจาก .env หรือไม่ได้ถูกโหลด ทดสอบรหัสผ่านที่ Redis ต้องการโดยตรงด้วย docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping' ซึ่งควรตอบกลับ PONG เครื่องหมาย single quote มีความสำคัญ เพราะทำให้ตัวแปรถูกแทนค่าภายใน container ซึ่งอ่านค่า .env แทนที่จะถูกแทนค่าใน shell ของคุณเอง ซึ่งโดยปกติจะเป็นค่าว่าง

Container หยุดทำงานพร้อม code 137 นั่นคือ SIGKILL ในเครื่องขนาดเล็ก ผู้ส่งสัญญาณที่พบบ่อยคือ kernel's out of memory killer แต่ docker kill ก็ส่งสัญญาณเดียวกันได้ ดังนั้นให้ตรวจสอบ sudo dmesg -T | grep -i "killed process" ก่อนสรุปว่าเกิดจากหน่วยความจำ หากเป็นปัญหาหน่วยความจำ ให้เพิ่ม swap, กำหนด memory limits ต่อ service หรือย้ายไปใช้ plan ที่มีขนาดใหญ่ขึ้น

FAQ

VPS สำหรับ self-host Chatwoot ต้องใช้ RAM เท่าใด

ณ เดือนตุลาคม 2026 ข้อกำหนดขั้นต่ำจากผู้พัฒนาคือ RAM 4 GB และ CPU 4 คอร์ สำหรับรองรับการสนทนาสูงสุด 10,000 รายการต่อวัน และ RAM 8 GB พร้อม CPU 8 คอร์ สำหรับรองรับสูงสุด 20,000 รายการ ควรเพิ่ม swap อย่างน้อย 1 GB เพราะกระบวนการอัปเกรดจะรัน Rails process ตัวที่สองเพื่อทำ migration ซึ่งเป็นจุดที่เซิร์ฟเวอร์ขนาดเล็กมักประสบปัญหาหน่วยความจำไม่พอ VPS ขนาด 2 GB สามารถบูตและใช้งานสำหรับเจ้าหน้าที่จำนวนน้อยได้ แต่เฉพาะ Sidekiq ตัวเดียวก็อาจใช้ RAM เกิน 1 GB เมื่อมีโหลดสูง ดังนั้นให้คาดการณ์ไว้ว่าคอนเทนเนอร์อาจถูกสั่งหยุดทำงานด้วย exit code 137 ในช่วงที่มีการใช้งานหนาแน่นหรือระหว่างการอัปเกรด

ทำไมอีเมลรีเซ็ตรหัสผ่านของ Chatwoot ถึงไม่ส่งมา

เพราะไม่ได้ตั้งค่า SMTP_ADDRESS ทำให้ Chatwoot เลือกใช้การส่งผ่าน sendmail ซึ่งผู้พัฒนาออกแบบมาสำหรับเซิร์ฟเวอร์ Postfix ที่ติดตั้งบนโฮสต์ แต่การตั้งค่า Docker นี้ไม่มีส่วนประกอบดังกล่าว งานนี้รันอยู่ใน Sidekiq ดังนั้นข้อผิดพลาดในการส่งจะไปปรากฏใน log ของ Sidekiq ในขณะที่เบราว์เซอร์ยังคงแสดงข้อความว่าสำเร็จ ให้ตั้งค่า SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD และ MAILER_SENDER_EMAIL ใน .env จากนั้นรีสตาร์ทบริการ rails และ sidekiq แล้วตรวจสอบ docker compose logs -f sidekiq ในขณะที่คุณกดสั่งรีเซ็ตรหัสผ่าน

ต้องสำรองข้อมูลส่วนใดบ้างเพื่อกู้คืน Chatwoot

ฐานข้อมูล Postgres, Docker volume ของ storage_data, ไฟล์ .env และไฟล์ compose ทั้งหมด การสำรองเฉพาะฐานข้อมูลไม่เพียงพอ เพราะไฟล์ที่อัปโหลดจะอยู่ใน volume ในขณะที่ Postgres เก็บเพียงข้อมูลอ้างอิงเท่านั้น ดังนั้นการกู้คืนเฉพาะฐานข้อมูลจะทำให้การสนทนาของคุณมีไฟล์แนบที่เปิดไม่ได้ .env มีความสำคัญมากเพราะ SECRET_KEY_BASE ที่ต่างกันจะทำให้ผู้ใช้ทุกคนถูกออกจากระบบ และ ACTIVE_RECORD_ENCRYPTION_* ที่ต่างกันจะทำให้คอลัมน์ที่เข้ารหัสไว้ไม่สามารถอ่านได้

จะอัปเกรด Chatwoot อย่างไรไม่ให้ฐานข้อมูลเสียหาย

ให้สำรองข้อมูล อ่านบันทึกการเปลี่ยนแปลง (release notes) ระหว่างเวอร์ชันที่คุณใช้อยู่กับเวอร์ชันเป้าหมาย เปลี่ยน image tag ในไฟล์ compose ของคุณ จากนั้นรัน docker compose pull, docker compose down, docker compose run --rm rails bundle exec rails db:chatwoot_prepare และ docker compose up -d ให้ทำการ pull image ก่อนเสมอเพราะการทำ migration ต้องรันจาก image ใหม่ และหยุด stack ก่อนเพื่อป้องกันไม่ให้โค้ดเวอร์ชันเก่าทำงานกับ schema ใหม่จนเกิดข้อผิดพลาด เฉพาะการติดตั้งที่เก่ามากเท่านั้นที่อาจจำเป็นต้องอัปเกรดผ่านเวอร์ชันกลางแทนการข้ามไปเวอร์ชันล่าสุดทันที โดยต้องรันขั้นตอนเตรียมการ (prepare step) หลังจากอัปเกรดแต่ละขั้น

สามารถใช้ postgres image มาตรฐานแทน pgvector ได้หรือไม่

ไม่ได้ เนื่องจาก schema ของ Chatwoot มีการเปิดใช้งาน extension vector ดังนั้น image postgres มาตรฐานจะล้มเหลวระหว่างขั้นตอน db:chatwoot_prepare ด้วยข้อผิดพลาด ERROR: extension "vector" is not available เพราะไฟล์ควบคุมของ extension ดังกล่าวไม่มีอยู่ใน image นั้น ให้ใช้ pgvector/pgvector:pg16 จากไฟล์ compose ของผู้พัฒนา หรือใช้ image อื่นที่มี pgvector สำหรับ Postgres เวอร์ชันหลักที่คุณใช้งานอยู่

บทความนี้มีประโยชน์หรือไม่