SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor

Paano Mag-self-host ng Chatwoot sa VPS gamit ang Docker

I-deploy ang Chatwoot sa VPS gamit ang Docker Compose at Traefik, pinned tags, SMTP na talagang nagpapadala, Postgres at uploads backups, at ligtas na upgrades.

Mga binubuo mo

Para mag-self-host ng Chatwoot sa isang VPS, magpapatakbo ka ng apat na container: isang Rails web process, isang Sidekiq background worker, PostgreSQL na may pgvector extension, at Redis. Ang Chatwoot ay isang open source customer support desk, kaya magkakaroon ka ng shared team inbox at website chat widget sa server na kontrolado mo. Tumatagal nang humigit-kumulang dalawampung minuto ang installation. Ang lahat pagkatapos nito—mail delivery, backups, upgrades, at sizing—ang magpapasya kung tumatakbo pa rin ito makalipas ang isang taon.

May isang trabaho ang bawat container. Ibinibigay ng Rails ang agent dashboard at widget API (application programming interface). Isinasagawa ng Sidekiq ang mabibigat na background task: pagpapadala ng email, pag-poll sa mga nakakonektang channel, pagpapatakbo ng automation rules, at pagbuo ng reports. Nag-iimbak ang Postgres ng mga conversation, contact, agent account, at bawat setting na binabago mo sa dashboard. Nag-iimbak ang Redis ng mga Sidekiq queue at ng ActionCable pub/sub channel na nagtutulak ng bagong mensahe sa bukas na dashboard nang hindi nire-reload ang page. Hindi lang pansamantalang cache ang Redis dito, dahil kapag nawala ito, mawawala rin ang mga naka-queue na job.

Ang Postgres image sa upstream compose file ay pgvector/pgvector:pg16 sa halip na stock na postgres image, dahil ine-enable ng Chatwoot schema ang vector extension para sa AI features nito. Kapag pinalitan mo ito ng stock Postgres, hihinto ang unang database run na may ERROR: extension "vector" is not available, dahil wala sa image na iyon ang control file ng extension. Gamitin ang image na nire-release ng upstream.

Ipinapalagay ng guide na ito na gumagana na ang Docker at reverse proxy sa server. Kung hindi pa, magsimula sa Docker Compose sa isang VPS at bumalik dito.

Gaano kalaking VPS ang kailangan ng self-hosted na Chatwoot?

Noong October 2026, hinihingi ng upstream requirements page ang 4 GB RAM at 4 CPU cores bilang minimum, at itinuturing nitong sapat iyon para sa hanggang 10,000 conversation bawat araw. Para naman sa hanggang 20,000 bawat araw, inirerekomenda nito ang 8 GB RAM at 8 cores. Nangangailangan din ito ng hindi bababa sa 1 GB swap. Direktang binanggit ang dahilan: para hindi maubusan ng memory ang machine habang nag-a-upgrade. Maglaan ng 5 GB hanggang 10 GB na disk para sa Postgres bago isama ang space para sa mga file upload.

Diretsahan: Magbo-boot ang Chatwoot sa 2 GB VPS, at mukhang maayos ito kapag dalawang agent lang at kaunti ang laman ng inbox. Pero bumibigay ito sa dalawang sitwasyon. Una ang Sidekiq, na ayon sa upstream ay gumagamit ng mahigit 1 GB sa isang busy na server. Dahil dito, maaaring lumampas sa available memory ang server kapag may biglang dagsa ng email o may report job, bago pa makuha ng Rails, Postgres, at Redis ang kani-kanilang bahagi. Ikalawa ang upgrade, dahil db:chatwoot_prepare ay nagbo-boot ng bagong Rails process para ilapat ang migrations, at ang pag-boot ng Rails sa image na ito ay kumokonsumo ng daan-daang megabyte bago pa ito makagawa ng kapaki-pakinabang na trabaho.

Hindi muna magpapakita ng maayos na warning ang system. Magpapadala ang kernel's out of memory killer ng SIGKILL sa napili nitong process, karaniwan sa pinakamalaki. Makikita ng Docker na tumigil ang container, at restart: always itong sisimulan muli. Ipapakita naman ng docker compose ps --all ang container na paulit-ulit na nagre-restart o nananatili sa Exited (137), kung saan ang 137 ay nangangahulugang pinatay ito ng signal 9. Kapag iniwan ang --all, hindi talaga ililista ang tumigil na container. Hindi sapat ang exit code 137 para patunayan na memory ang sanhi, dahil docker kill ay nagpapadala rin ng parehong signal. Kumpirmahin ito gamit ang sudo dmesg -T | grep -i "killed process", na tumutukoy sa process na pinili ng kernel.

Kung lampas sa budget ang 4 GB, maaari kang gumamit ng 2 GB server na may 2 GB swap, pero tanggapin na hahaba ang response time kapag may load. Buffer lamang ang swap laban sa pagkaubos ng memory; hindi ito garantiya. Kaya maaari pa ring mapatay ang isang container kapag sapat ang laki ng biglang load. Mainam pa ring magtakda ng hard memory ceiling para sa bawat service, upang hindi maisama ng worker ang database kapag bumigay ito. Tingnan ang memory limits sa Docker Compose.

Ang mga file upload ang bahaging patuloy na lumalaki nang walang limit na itinakda mo. Ang bawat screenshot na ina-attach ng customer ay napupunta sa storage volume at nananatili roon. Kaya i-monitor ang docker system df -v sa halip na ipagpalagay na database ang pumuno sa disk.

Kunin ang compose file at i-pin ang version tag

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

Nakasaad sa file na kaka-download mo lang ang image: chatwoot/chatwoot:latest. Palitan ito bago ka gumawa ng iba pa.

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

Ibig sabihin ng latest, ibibigay sa iyo ng susunod na docker compose pull ang anumang na-publish noong umagang iyon. Maaaring kabilang dito ang isang major version na may mga migration na hindi mo pa nababasa. Sa aktuwal na paggamit, hindi reversible ang Chatwoot migrations. Kaya kapag aksidenteng lumundag ang version, kailangan mong mag-restore mula sa backup sa halip na mag-undo. I-pin ang tag at baguhin ito nang sadya. Ang v4.19.1 ang kasalukuyang release noong 25 October 2026, at inirerekomenda ito ng release notes para sa pinakabagong security fixes at hardening improvements. Tingnan ang releases page para malaman kung aling tag ang dapat mong i-pin ngayon. Kung mag-a-upgrade ka mula sa v4.18.0 o mas luma, basahin muna ang v4.19.0 notes: retired na ang Captain V1, at kailangang i-migrate sa V2 ang mga self-hosted installation na gumagamit ng V1 instructions bago mag-upgrade. Ganoon din ang pag-iingat sa anumang may sariling database. Kaya nagsisimula sa pag-pin ng git tag ang pag-self-host ng openGym workout tracker, kahit mas maliit na application ito kumpara rito.

Ang base service ay isang YAML anchor na parehong mina-merge ng rails at sidekiq. Kaya kapag binago mo ang tag sa isang lugar, magbabago ito para sa pareho. Habang nasa file ka, burahin ang version: '3' line sa itaas. Hindi na ito pinapansin ng modern Compose at nagpi-print ng the attribute 'version' is obsolete, it will be ignored sa bawat command.

Punan ang .env file

Bumuo muna ng secret. Humihingi ang upstream ng alphanumeric na value dahil maaaring ma-modify ang special characters kapag dumaan ang value sa shell o YAML parser.

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

Pagkatapos, itakda ang mga key na ito sa .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

Ang POSTGRES_HOST=postgres at redis://redis:6379 ang mga pangalan ng Compose service na nareresolba sa default network ng project. Hindi dekorasyon ang FRONTEND_URL. Ginagamit ito ng Chatwoot para buuin ang widget script URL at lahat ng link sa mga outgoing email. Kaya kapag mali ang value, maglalaman ang password reset link ng host na hindi sumasagot.

Narito ang karaniwang bitag sa upstream file. Hindi binabasa ng postgres service ang .env. May sarili itong environment block, at walang laman ang POSTGRES_PASSWORD=. Kaya kung itatakda mo lamang ang password sa .env, walang password ang database pero may password ang application. Ituro ang service sa parehong variable:

  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}

Binabasa ng Compose ang .env mula sa project directory para sa ${...} substitution. Dahil dito, pareho na ang string na matatanggap ng dalawang panig. Kapag mali ito, hihinto ang Rails at magpapakita ng PG::ConnectionBad: FATAL: password authentication failed for user "postgres".

May isang behavior na kadalasang ikinagugulat ng halos lahat: inilalapat ng Postgres image ang POSTGRES_PASSWORD kapag nag-initialize lamang ito ng walang lamang data directory. Walang epekto ang pagpapalit ng value pagkatapos nito dahil hindi na muling tumatakbo ang initdb. Kung nasimulan mo na ang stack, palitan ang value sa loob mismo ng database.

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

Temporary ang ENABLE_ACCOUNT_SIGNUP=true. Binubuksan nito ang public registration form para makagawa ka ng unang account. Itakda ito sa false at patakbuhin muli ang docker compose up -d pagkalikha ng account. Kung hindi, maaaring mag-register sa support desk mo ang sinumang makahanap ng URL. Pagkatapos nito, sa pamamagitan ng invitation pumapasok ang mga agent, at sa iisang app lamang nakalagay ang kanilang mga password. Ayos ito hanggang sa magpatakbo ka ng kalahating dosenang service at magsawa sa magkakahiwalay na account list sa bawat isa. Sa puntong iyon, isang self-hosted identity provider gaya ng Authentik ang pumapalit sa mga ito.

Nasa .env na ngayon ang lahat ng secret ng stack na ito bilang plain text. Panatilihin itong nasa mode 600 at huwag isama sa git. Sinasaklaw ng Paano nagbabasa ang Compose ng env file at kung saan nalalantad ang mga secret ang mahahalagang panganib, kabilang ang pagkakaiba ng env_file at environment.

Ilagay ang Chatwoot sa likod ng iyong kasalukuyang Traefik

Huwag gumawa ng pangalawang reverse proxy para sa isang application. Kung nagte-terminate na ang Traefik ng TLS (transport layer security) para sa iba pang container sa server na ito, isama ang Chatwoot gamit ang isang label block. Kung wala ka pa nito, i-set up muna ito nang isang beses gamit ang Traefik sa harap ng ilang Docker Compose app, pagkatapos ay bumalik dito.

Panatilihing malapit sa stock ang upstream na docker-compose.yaml para maikumpara mo ito sa mas bagong kopya sa hinaharap, at ilagay ang iyong mga pagbabago sa isang override file. Awtomatikong mina-merge ng Compose ang docker-compose.override.yaml, at ipinapaliwanag ng paghahati ng Compose sa maraming file ang mga panuntunan sa pag-merge.

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

Gamitin ang sarili mong mga pangalan para sa entrypoint at certresolver. Dapat nasa parehong Docker network ng Traefik ang container. Ito ang ginagawa ng proxy entry. Dapat manatili rin ito sa default, kung hindi mawawalan ito ng access sa Postgres at Redis. Ang ikalawang linyang ito ang madalas nakalilimutan.

Huwag baguhin ang ports: block. Naka-bind ito ng upstream sa 127.0.0.1:3000, na loopback lamang. Kaya hindi ito naaabot mula sa internet, at nananatili itong kapaki-pakinabang para sa testing mula sa loob ng server gamit ang curl -I http://127.0.0.1:3000.

Nananatiling bukas ang websocket ng agent dashboard sa /cable para sa live na paghahatid ng mensahe. Ipinapasa ng Traefik ang HTTP upgrade nang walang karagdagang configuration, kaya wala kang kailangang idagdag. Kung maglalagay ka sa hinaharap ng CDN o iba pang proxy sa harap ng Traefik, payagan doon ang websockets. Ang sintomas ay dashboard na normal na naglo-load, pero lumalabas lamang ang mga bagong mensahe matapos ang manual refresh.

Inisyalisa ang database at simulan ang stack

I-start muna ang mga data service at hintaying matapos ng Postgres ang first run nito.

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

Hintayin ang database system is ready to accept connections. Pagkatapos, gawin ang schema.

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

Ginagawa nito ang database kung wala pa ito, pagkatapos ay nilo-load ang schema at ang default seed data. Nagpi-print ito ng mga migration line at malinis na nag-e-exit. Kung patuloy itong nagpi-print ng postgres:5432 - no response, naghihintay ang entrypoint sa database na hindi pa tumatanggap ng connections. Sa first run, karaniwang ibig sabihin nito ay gumagana pa ang initdb. Maghintay, basahin ang Postgres logs, pagkatapos ay patakbuhin itong muli. Kung huminto ito sa vector extension, pinalitan mo ang pgvector image ng stock Postgres.

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

Dapat magpakita ang lahat ng apat na container ng Up, at dapat magtapos ang rails log sa isang Puma line na nakikinig sa http://0.0.0.0:3000. Pagkatapos, suriin ang public path:

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

Ibig sabihin ng HTTP/2 200 ay gumagana ang buong chain. Ang 404 mula sa Traefik ay nangangahulugang hindi tumugma ang router rule, karaniwan dahil may typo sa hostname. Ang 502 ay nangangahulugang tumugma ang Traefik sa router ngunit hindi nito maabot ang container. Halos palaging nawawala ang proxy network, o may loadbalancer.server.port na hindi 3000.

Buksan ang URL, gawin ang iyong account sa /app/auth/signup, pagkatapos ay itakda ang ENABLE_ACCOUNT_SIGNUP=false at patakbuhin ang docker compose up -d upang isara ang form.

Bakit hindi gumagana ang password reset at mga email conversation kapag walang SMTP

Ang Chatwoot na walang SMTP (simple mail transfer protocol) settings ay isang support desk na hindi makapagpadala ng email, at hindi lang notifications ang naaapektuhan nito. Hindi gumagana ang password reset, kaya mananatiling naka-lock out ang admin na nawalan ng access. Hindi rin gumagana ang agent invitations dahil email ang isang invitation. Hindi gumagana ang pagsagot sa customer sa isang email conversation, kaya iisang direksyon lang ang daloy ng conversation. Ito ang hakbang na nilalaktawan ng marami at saka natutuklasan sa pinakamasamang panahon.

Simple ang mekanismo. Kapag walang nakatakdang SMTP_ADDRESS, inililipat ng Chatwoot ang ActionMailer sa sendmail delivery. Idinodokumento ito ng upstream bilang Postfix setup, na default mula pa noong v2.12.0, at nag-i-install ang mga instruction nito ng Postfix sa server gamit ang sudo apt install -y postfix. Hindi ito ginagawa ng Docker setup na ito, kaya walang naka-configure na mail server na mapagpapasahan ng delivery para sa mail. Isinasagawa ang pagpapadala ng mail mula sa background job, kaya napupunta sa Sidekiq log ang anumang error mula sa delivery at hindi sa Rails log. Samantala, nakakakita ng masayang confirmation ang taong nagki-click sa "forgot password" pero walang natatanggap na email.

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

Gamitin ang port 587 na may STARTTLS. Binubuksan nito ang connection bilang plain text at ina-upgrade ito sa encrypted connection bago ang authentication. Maraming VPS provider ang default na nagba-block ng outbound port 25 upang limitahan ang spam. Noong 8 November 2026, bina-block ng Hetzner ang ports 25 at 465 bilang default sa cloud servers, at ipinapatupad ang blocking sa bawat account. Bina-block naman ng Vultr ang port 25 sa lahat ng bagong Compute Instances. Sinusuri ng dalawang provider ang mga request para alisin ang block nang paisa-isa. Hinihingi ng Hetzner na isang buwan ka nang customer at nabayaran na ang unang invoice bago ka makapagsumite ng limit request. Hindi bina-block ng alinman sa kanila ang 587, kaya gumagana ang relay sa 587 mula sa unang boot nang walang ticket at paghihintay. Ang SMTP_DOMAIN ay ang domain na ipinapakilala ng server mo habang isinasagawa ang SMTP conversation. Tinatanggihan ng ilang relay ang hindi tugmang domain.

I-apply ang settings at i-monitor ang worker:

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

Mag-trigger ng password reset mula sa login page. Kapag gumagana ang delivery, makikita sa Sidekiq log na normal na natatapos ang mailer job. Kapag may failure, makikita muna ang exception class, pagkatapos ay magre-retry ang Sidekiq na may lumalaking backoff. Dahil dito, ang sirang relay ay nagdudulot ng parehong error kada ilang minuto sa loob ng ilang oras.

Dalawang rejection ang karaniwan, at hindi Chatwoot bug ang alinman sa mga ito. Ang 535 Authentication failed ay nangangahulugang nabigo ang authentication. Suriin ang credentials, kung naka-enable ang SMTP authentication, at kung bina-block ito ng access policy. Hindi sapat na may tamang credentials upang maalis ang error na ito. Nangangailangan ang ilang provider ng application password sa halip na password ng account. Ang 550 Sender address rejected ay nangangahulugang tinanggihan ng server ang sender address. Basahin ang buong response bago baguhin ang MAILER_SENDER_EMAIL. Maaaring sanhi ito ng sender permissions o verification, ngunit ang 550 5.7.27 Sender address rejected: Domain does not accept mail ay tumutukoy sa sender domain na may null MX record.

Hiwalay na trabaho ang pagtanggap ng email sa isang conversation. Para sa forwarding sa pamamagitan ng Chatwoot ingress, kailangan nito ang MAILER_INBOUND_EMAIL_DOMAIN at RAILS_INBOUND_EMAIL_SERVICE, pati ang mail server na nagpapasa ng mga papasok na mensahe sa Chatwoot. Maaari ka ring magkonekta ng mailbox sa pamamagitan ng IMAP, kabilang ang Google o Microsoft OAuth, nang hindi kino-configure ang forwarding path na iyon. Ang pagrenta ng relay ang pinakamabilis na paraan. Kung mas gusto mong ikaw ang mamahala sa buong mail path, ipinapaliwanag ng pagpapatakbo ng sarili mong mail server gamit ang Mailcow kung ano talaga ang kailangan sa commitment na ito.

Ano ang dapat i-back up, at paano patutunayang gumagana ang restore

May apat na bahagi ang backup ng Chatwoot. Kapag may isang nilaktawan, magiging rebuild ang restore sa halip na tunay na recovery.

  • Ang Postgres database, na naglalaman ng mga conversation, contact, agent account, at lahat ng setting.
  • Ang storage_data volume, dahil nagsusulat ang ACTIVE_STORAGE_SERVICE=local ng mga uploaded file sa disk at reference row lamang ang itinatago nito sa Postgres.
  • Ang .env file, dahil naglalaman ito ng SECRET_KEY_BASE at mga ACTIVE_RECORD_ENCRYPTION_* key.
  • Ang compose files, dahil itinatala ng mga ito ang eksaktong image tag na katugma ng schema ng database.

Kung database lamang ang ire-restore, babalik ang bawat conversation na sira ang mga attachment dahil tumuturo ang mga row sa mga file na wala na sa disk.

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

Mahalaga ang -T. Kung wala ito, naglalaan ang Compose ng pseudo terminal na nagre-rewrite ng newline bytes sa stream. Dahil dito, makakakuha ka ng dump file na tinatanggihan ng pg_restore. Ang -Fc ang custom format na nagko-compress at nagbibigay-daan sa pg_restore na gumana nang pili lamang.

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

Ang pangalan ng volume ay pangalan ng iyong project directory na sinusundan ng _storage_data. Kumpirmahin ito gamit ang docker volume ls | grep storage_data bago pagkatiwalaan ang command na iyon, dahil gumagawa ang Docker ng walang laman na volume sa halip na mag-fail kapag nagbigay ka ng pangalang hindi umiiral. Makakakuha ka ng valid ngunit walang laman na archive at walang error. Suriin ang laki nito pagkatapos gamit ang ls -lh storage-*.tgz.

Nasa parehong disk na ngayon ang dalawang file at ang pinoprotektahan ng mga ito. Wala itong naitutulong sa iyo kapag nasira o nawala ang disk. Ipadala ang mga ito sa labas ng server at i-encrypt, dahil naglalaman ang database dump ng bawat mensahe ng customer bilang plain text. Sinasaklaw ng Mga naka-encrypt na off-site backup gamit ang restic ang pag-schedule at retention.

Ang restore drill; patakbuhin ito bago mo ito kailanganin

Mag-restore sa pangalawang VPS, hindi sa live na server. I-copy ang .env, ang compose files, at ang dalawang archive, pagkatapos ay patakbuhin:

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

Binabagsak ng --clean --if-exists ang mga umiiral na object bago mag-load. Ituro lamang ito sa database na handa mong mawala. Pagkatapos, mag-sign in at magbukas ng conversation na may attachment. Kung naglo-load ang listahan ng mga mensahe at nada-download ang file, tunay na gumagana ang backup.

Ang restore gamit ang ibang SECRET_KEY_BASE ay nagpapawalang-bisa sa bawat session cookie, kaya masa-sign out ang lahat. Mas malala ang restore gamit ang ibang ACTIVE_RECORD_ENCRYPTION_* key: hindi ma-decrypt ng Chatwoot ang mga column na naglalaman ng channel credentials at maglalabas ito ng ActiveRecord::Encryption::Errors::Decryption. Kaya kasama sa backup list ang .env.

Paano i-upgrade ang Chatwoot sa bagong tag

Mas mahalaga ang tamang pagkakasunod-sunod kaysa sa mismong mga command.

  1. Basahin ang release notes sa pagitan ng iyong tag at ng target tag. Hanapin ang mga kinakailangang manual na hakbang.
  2. Gumawa ng bagong database dump at storage archive. Tiyaking makatwiran ang laki ng parehong file.
  3. I-edit ang image tag ng base service sa docker-compose.yaml.
  4. I-pull ang bagong image, ihinto ang stack, patakbuhin ang migrations, at pagkatapos ay simulan itong muli.
docker compose pull
docker compose down
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
docker compose images

I-pull muna ang image bago patakbuhin ang migration. Kailangang mula sa bagong image patakbuhin ang migration dahil wala sa lumang image ang mga bagong migration file. Ihinto ang stack bago mag-migrate dahil hindi tugma ang lumang code at bagong schema. Maaaring magtaas ng error ang tumatakbong lumang Rails process o magsulat ng mga row na hindi tatanggapin ng bagong schema. Pinapalaya rin ng paghinto ang memory na kailangan ng migration. Ito ang dahilan kung bakit humihingi ang upstream ng swap.

Ipinapakita ng docker compose images ang tag na aktuwal na ginagamit ng bawat container. Nahuhuli nito ang sitwasyong na-edit mo ang tag pero nakalimutan mong i-pull ang image.

Depende sa edad ng install kung gaano kalaking laktaw ang maaari mong gawin. Kung isa o dalawang release lang ang layo ng install, basahin ang release notes sa pagitan ng iyong tag at ng target tag, itakda ang target tag, at isang beses patakbuhin ang mga hakbang sa itaas. Kung napakaluma lamang ng installation, sinasabi ng Docker guide ng upstream na mag-upgrade nang paisa-isa sa pamamagitan ng mga intermediate image tag sa halip na direktang lumipat sa pinakabagong image. Sa ganitong sitwasyon, ulitin ang pagpapalit ng tag, pag-pull, at prepare step para sa bawat intermediate tag dahil hinihingi ng upstream ang db:chatwoot_prepare pagkatapos ng bawat upgrade.

Kung magsisimula ang Rails bago patakbuhin ang migration, tatanggi itong mag-serve at ila-log ang ActiveRecord::PendingMigrationError: Migrations are pending. Kapag nakatakda ang restart: always, paulit-ulit na nagre-restart ang container. Dahil dito, ipinapakita ng docker compose ps ang uptime na nagre-reset bawat ilang segundo. Patakbuhin ang prepare step upang ma-clear ito.

Ang rollback ay nangangahulugang ibalik ang lumang tag at i-restore ang dump. Walang reverse migration path na maaasahan. Ito ang dahilan kung bakit kailangan ang step 2.

Mga failure mode at mga string na makikita mo

502 Bad Gateway mula sa Traefik. Na-match ang router pero hindi sumagot ang backend. Tingnan sa docker compose ps kung ipinapakitang Up ang rails, pagkatapos ay patakbuhin ang docker network inspect proxy at tiyaking lumilitaw ang rails container sa listahan ng mga container nito. Hindi nakikita ng Traefik ang container na hindi naka-attach, kaya nami-match ang request sa isang router ngunit walang mapuntahan.

Naglo-load ang dashboard pero kailangan ng refresh para lumitaw ang mga bagong message. Hindi nakakalusot ang websocket papunta sa /cable, o hindi tumutugma ang FRONTEND_URL sa address sa browser bar. Kapag hindi tumutugma ang mga ito, sinusubukan ng page na magbukas ng websocket sa ibang origin, na bina-block ng browser.

FATAL: password authentication failed for user "postgres". Magkaiba ang password sa .env at ang password na naka-store sa Postgres data volume. Ayusin ito gamit ang ALTER USER sa loob ng tumatakbong container, dahil hindi mababago ng muling pag-edit sa .env ang database na na-initialize na.

NOAUTH Authentication required. Tumatakbo ang Redis gamit ang --requirepass ngunit kumonekta ang application nang walang password, kaya wala ang REDIS_PASSWORD sa .env o hindi ito nabasa ng application. Direktang i-test ang password na inaasahan ng Redis gamit ang docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping'. Dapat itong sumagot ng PONG. Mahalaga ang single quotes: tinitiyak nitong sa loob ng container mag-expand ang variable, kung saan binabasa nito ang .env, sa halip na sa sarili mong shell, kung saan karaniwan itong walang laman.

Mga container na lumalabas na may code 137. SIGKILL iyon. Sa maliit na server, karaniwang ang kernel's out-of-memory killer ang nagpapadala nito, pero nagpapadala rin ng parehong signal ang docker kill. Suriin ang sudo dmesg -T | grep -i "killed process" bago sisihin ang memory. Kung memory nga ang problema, magdagdag ng swap, magtakda ng per-service memory limits, o lumipat sa mas malaking plan.

FAQ

Gaano karaming RAM ang kailangan ng isang self-hosted Chatwoot VPS?

Noong October 2026, hinihingi ng upstream ang minimum na 4 GB RAM at 4 CPU cores, para sa hanggang 10,000 conversation bawat araw, at 8 GB na may 8 cores para sa hanggang 20,000. Magdagdag ng hindi bababa sa 1 GB swap, dahil nagpapatakbo ang upgrade ng ikalawang Rails process para ilapat ang migrations, at dito nauubusan ng memory ang maliliit na server. Nagbo-boot at gumagana ang 2 GB VPS para sa ilang agent, pero maaaring lumampas sa 1 GB ang Sidekiq kapag mataas ang load. Kaya asahan ang pagpatay sa mga container na may exit code 137 kapag abala ang system at habang nag-a-upgrade.

Bakit hindi dumarating ang mga email para sa pag-reset ng password sa Chatwoot?

Dahil walang nakatakdang SMTP_ADDRESS, kaya bumabalik ang Chatwoot sa sendmail delivery. Nilalayon ito ng upstream para sa Postfix server na naka-install sa host, pero walang ganoon sa Docker setup na ito. Tumatakbo ang job sa Sidekiq, kaya napupunta sa Sidekiq log ang anumang delivery error habang success message pa rin ang ipinapakita ng browser. Itakda ang SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD at MAILER_SENDER_EMAIL sa .env, i-restart ang rails at sidekiq services, pagkatapos ay i-monitor ang docker compose logs -f sidekiq habang nagti-trigger ka ng reset.

Ano ang kailangan kong i-back up para ma-restore ang Chatwoot?

Ang Postgres database, ang storage_data Docker volume, ang .env file, at ang mga compose file. Hindi sapat ang database lamang, dahil nasa volume ang mga in-upload na file habang references lamang sa mga ito ang nasa Postgres. Kaya kapag database-only ang restore, magkakaroon ka ng mga conversation na sira ang mga attachment. Mahalaga ang .env dahil sina-sign out ng ibang SECRET_KEY_BASE ang lahat ng user. Dahil naman sa ibang ACTIVE_RECORD_ENCRYPTION_* keys, hindi mababasa ang mga encrypted column.

Paano ko ia-upgrade ang Chatwoot nang hindi nasisira ang database?

Gumawa ng backup, basahin ang release notes sa pagitan ng iyong tag at ng target, palitan ang image tag sa compose file, pagkatapos ay patakbuhin ang docker compose pull, docker compose down, docker compose run --rm rails bundle exec rails db:chatwoot_prepare at docker compose up -d. Mag-pull muna dahil kailangang mula sa bagong image tumakbo ang migrations. Ihinto rin muna ang stack dahil nagdudulot ng error ang paggamit ng lumang code laban sa bagong schema. Ang napakalumang install lamang ang kailangang dumaan sa mga intermediate image tag sa halip na direktang mag-upgrade sa pinakabagong version. Patakbuhin ang prepare step pagkatapos ng bawat tag.

Maaari ko bang gamitin ang standard postgres image sa halip na pgvector?

Hindi. Ine-enable ng schema ng Chatwoot ang vector extension. Kaya nagfa-fail ang stock postgres image habang nasa db:chatwoot_prepare, na may ERROR: extension "vector" is not available, dahil wala sa image na iyon ang control file ng extension. Panatilihin ang pgvector/pgvector:pg16 mula sa upstream compose file, o gumamit ng ibang image na may kasamang pgvector para sa iyong Postgres major version.

Nakatulong ba ang artikulong ito?

#chatwoot#self-hosting#docker-compose#support-desk#smtp#backups