SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Як розгорнути Chatwoot на VPS через Docker

Покрокове розгортання Chatwoot на VPS через Docker Compose і Traefik: зафіксовані теги, робочий SMTP, резервні копії Postgres та uploads і безпечні оновлення.

Що ви розгортаєте

Щоб розмістити Chatwoot на VPS, потрібно запустити чотири контейнери: вебпроцес Rails, фоновий worker Sidekiq, PostgreSQL із розширенням pgvector і Redis. Chatwoot — це open source система підтримки клієнтів. Вона надає спільну командну скриньку та вебвіджет чату на сервері під вашим керуванням. Встановлення займає близько двадцяти хвилин. Далі все залежить від доставки пошти, резервного копіювання, оновлень і вибору ресурсів. Саме це визначає, чи працюватиме система через рік.

Кожен контейнер має окреме завдання. Rails обслуговує панель оператора та API віджета. Sidekiq виконує повільні операції: надсилає електронні листи, опитує підключені канали, запускає правила автоматизації та формує звіти. Postgres зберігає розмови, контакти, облікові записи операторів і всі налаштування, які ви змінюєте в панелі. Redis зберігає черги Sidekiq і канал pub/sub ActionCable, який передає нове повідомлення у відкриту панель без перезавантаження сторінки. У цій схемі Redis не є тимчасовим кешем, оскільки його втрата означає втрату завдань у черзі.

В upstream-файлі compose використовується образ Postgres pgvector/pgvector:pg16, а не стандартний образ postgres, оскільки схема Chatwoot вмикає розширення vector для функцій AI. Якщо замінити його на стандартний Postgres, перший запуск бази даних завершиться помилкою ERROR: extension "vector" is not available, оскільки в цьому образі немає керівного файла розширення. Використовуйте образ, який постачається upstream.

У цьому посібнику передбачається, що Docker і reverse proxy вже працюють на сервері. Якщо це не так, спочатку ознайомтеся з матеріалом Docker Compose на VPS, а потім поверніться до цього посібника.

Скільки ресурсів VPS потрібні для self-hosted Chatwoot?

Станом на жовтень 2026 року на сторінці вимог upstream вказано мінімум 4 GB RAM і 4 CPU cores. Цього має вистачити максимум для 10,000 розмов на день. Для 8 GB і 8 cores вказано максимум 20,000 розмов на день. Також потрібно щонайменше 1 GB swap. Причина зазначена безпосередньо: це не дає машині вичерпати пам’ять під час оновлення. Перед завантаженням файлів закладіть від 5 GB до 10 GB дискового простору для Postgres.

Тепер без пом’якшень. VPS із 2 GB RAM запустить Chatwoot, і за наявності двох агентів та невеликої кількості повідомлень усе може працювати нормально. Але проблеми виникають у двох випадках. Перша — Sidekiq. За даними upstream, на завантаженому сервері він використовує понад 1 GB RAM. Тому сплеск вхідної пошти або запуск звіту вичерпує пам’ять ще до того, як свою частку отримають Rails, Postgres і Redis. Друга — оновлення. Під час оновлення db:chatwoot_prepare запускає новий процес Rails для застосування міграцій. Запуск Rails у цьому образі потребує сотень мегабайт ще до виконання корисної роботи.

Попередження зазвичай не з’являється. Засіб ядра out of memory killer надсилає SIGKILL вибраному процесу, зазвичай найбільшому. Docker бачить завершення контейнера, а restart: always запускає його знову. Після цього docker compose ps --all показує контейнер, який постійно перезапускається або перебуває у стані Exited (137), де 137 означає завершення сигналом 9. Якщо не вказати --all, зупинений контейнер взагалі не відображається. Сам код завершення 137 не доводить, що причиною була нестача пам’яті, оскільки docker kill надсилає той самий сигнал. Тому перевірте це за допомогою sudo dmesg -T | grep -i "killed process", який показує процес, вибраний ядром.

Якщо 4 GB RAM не вписуються в бюджет, використовуйте VPS із 2 GB RAM і 2 GB swap та врахуйте, що під навантаженням час відповіді збільшиться. Swap допомагає запобігти вичерпанню пам’яті, але не гарантує цього. Достатньо великий сплеск навантаження все одно може призвести до завершення контейнера. У будь-якому разі варто встановити жорстке обмеження пам’яті для кожного сервісу. Тоді worker не зможе через нестачу пам’яті зупинити базу даних. Див. обмеження пам’яті в Docker Compose.

Завантажені файли — це дані, обсяг яких зростає без встановленого вами обмеження. Кожен знімок екрана, прикріплений клієнтом, потрапляє у volume сховища й залишається там. Тому контролюйте docker system df -v, а не припускайте, що диск заповнила база даних.

Отримайте 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 отримає будь-яку версію, опубліковану того ранку. Це може бути мажорна версія з міграціями, про які ви ще не читали. На практиці міграції Chatwoot не можна скасувати, тому випадковий перехід на нову версію вимагає відновлення з резервної копії, а не простого скасування. Зафіксуйте тег і змінюйте його навмисно. Станом на 25 October 2026 актуальною була версія v4.19.1. У примітках до її випуску цю версію рекомендовано для отримання останніх виправлень безпеки та покращень захисту. Перевірте сторінку релізів, щоб визначити тег, який слід зафіксувати сьогодні. Якщо ви переходите з v4.18.0 або ранішої версії, спочатку прочитайте примітки до v4.19.0: Captain V1 виведено з експлуатації, а self-hosted інсталяції, налаштовані за інструкціями для V1, потрібно перенести на V2 перед оновленням. Така сама обережність потрібна для будь-якого застосунку, який працює з базою даних. Саме тому self-hosting трекера тренувань openGym починається з фіксації git-тега, хоча цей застосунок значно менший за поточний.

Сервіс base — це YAML-якір, який об’єднують і rails, і sidekiq. Тому зміна тега в одному місці змінює його для обох сервісів. Поки файл відкритий, видаліть рядок version: '3' на початку. Сучасний Compose його ігнорує та виводить the attribute 'version' is obsolete, it will be ignored під час кожної команди.

Заповніть файл .env

Спочатку згенеруйте секрет. Upstream вимагає алфавітно-цифрове значення, оскільки спеціальні символи можуть спотворюватися під час передавання значення через 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, які визначаються в мережі за замовчуванням цього проєкту. FRONTEND_URL — не декоративне поле. Chatwoot формує з нього URL скрипту віджета та кожного посилання у вихідному електронному листі. Тому неправильне значення створює посилання для скидання пароля на хост, який не відповідає.

Тепер пастка у файлі upstream. Сервіс 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 не запускається повторно. Якщо стек уже було запущено, змініть пароль безпосередньо в базі даних.

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, зможе зареєструватися у вашій системі підтримки. Надалі агенти отримують доступ за запрошеннями, а їхні паролі зберігаються лише в цьому застосунку. Цього достатньо, доки ви не запустите близько півдюжини сервісів і не втомитеся вести окремий список облікових записів у кожному. На цьому етапі self-hosted постачальник ідентифікації на кшталт Authentik замінює ці окремі списки.

.env тепер містить усі секрети цього стека у відкритому тексті. Тому встановіть для файлу режим 600 і не додавайте його до git. У матеріалі Як Compose читає env-файли та де витікають секрети розглянуто критичні нюанси, зокрема різницю між env_file і environment.

Розміщення Chatwoot за наявним Traefik

Не створюйте другий reverse proxy для одного застосунку. Якщо Traefik уже завершує TLS (transport layer security) для інших контейнерів на цьому сервері, Chatwoot підключається до нього через блок labels. Якщо Traefik ще не налаштований, спочатку налаштуйте його один раз за інструкцією Traefik перед кількома застосунками Docker Compose, а потім поверніться сюди.

Не змінюйте upstream docker-compose.yaml без потреби, щоб згодом можна було порівняти його з новішою копією через diff. Зміни виносьте в override-файл. 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:. Upstream прив’язує його до 127.0.0.1:3000, а це loopback-адреса. Тому сервіс недоступний з інтернету, але залишається придатним для тестування зсередини сервера через curl -I http://127.0.0.1:3000.

Панель оператора підтримує websocket-з’єднання з /cable для доставки повідомлень у реальному часі. Traefik пересилає HTTP upgrade без додаткової конфігурації, тому нічого додавати не потрібно. Якщо згодом розмістите CDN або інший proxy перед Traefik, дозвольте websocket-з’єднання на цьому рівні. Інакше панель завантажуватиметься нормально, але нові повідомлення з’являтимуться лише після ручного оновлення сторінки.

Ініціалізуйте базу даних і запустіть стек

Спочатку запустіть сервіси даних і дочекайтеся завершення першого запуску Postgres.

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

Дочекайтеся database system is ready to accept connections. Потім створіть схему.

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

Ця команда створює базу даних, якщо її немає, а потім завантажує схему та стандартні початкові дані. Вона виводить рядки міграції та завершується без помилок. Якщо вона продовжує виводити postgres:5432 - no response, entrypoint очікує базу даних, яка ще не приймає підключення. Під час першого запуску це зазвичай означає, що initdb ще виконується. Дочекайтеся завершення, перегляньте журнали Postgres і запустіть команду ще раз. Якщо виконання зупиняється на розширенні vector, ви замінили образ pgvector на стандартний Postgres.

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

Для всіх чотирьох контейнерів має відображатися Up, а журнал rails має завершуватися рядком Puma, що прослуховує http://0.0.0.0:3000. Потім перевірте публічний шлях:

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

HTTP/2 200 означає, що весь ланцюжок працює. Відповідь 404 від Traefik означає, що правило маршрутизатора не збіглося, зазвичай через помилку в імені хоста. Відповідь 502 означає, що Traefik зіставив маршрутизатор, але не зміг підключитися до контейнера. Майже завжди причина — відсутня мережа 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 перемикає ActionMailer на доставлення через sendmail. У документації upstream це описано як налаштування Postfix, яке є типовим починаючи з v2.12.0. Інструкція передбачає встановлення Postfix на сервері за допомогою sudo apt install -y postfix. У цьому Docker-налаштуванні цього не робиться, тому для цього способу доставлення немає налаштованого поштового сервера, якому можна передати лист. Лист надсилається з фонового завдання, тому помилка доставлення потрапляє до журналу Sidekiq, а не до журналу 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 November 2026 Hetzner типово блокує порти 25 і 465 на cloud servers; блокування застосовується окремо до кожного облікового запису. Vultr блокує порт 25 на всіх нових Compute Instances. Обидва провайдери розглядають запити на розблокування індивідуально. Hetzner вимагає бути клієнтом протягом місяця та сплатити перший рахунок, перш ніж можна буде подати запит на зміну ліміту. Порт 587 не блокується в жодного з них, тому relay на 587 працює вже після першого запуску без звернення в підтримку та очікування. SMTP_DOMAIN — це домен, який сервер оголошує під час SMTP-сеансу. Деякі relay відхиляють з’єднання, якщо він не збігається.

Застосуйте налаштування та спостерігайте за worker:

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

Запустіть скидання пароля зі сторінки входу. Якщо доставлення працює, у журналі Sidekiq буде видно штатне завершення завдання mailer. У разі помилки спочатку з’являється клас винятку, після чого Sidekiq повторює спробу зі щоразу довшою затримкою. Тому несправний relay спричиняє ту саму помилку кожні кілька хвилин протягом кількох годин.

Поширені два типи відмов, і жоден із них не є помилкою Chatwoot. 535 Authentication failed означає, що автентифікацію не пройдено. Перевірте облікові дані, чи ввімкнена SMTP-автентифікація та чи не блокує її політика доступу. Правильні облікові дані самі по собі не виключають цю помилку. Деякі провайдери вимагають пароль застосунку замість пароля облікового запису. 550 Sender address rejected означає, що сервер відхилив адресу відправника. Перш ніж змінювати MAILER_SENDER_EMAIL, прочитайте повну відповідь сервера. Однією з причин можуть бути обмеження або непідтверджена адреса відправника, але 550 5.7.27 Sender address rejected: Domain does not accept mail вказує на домен відправника з null MX-записом.

Отримання електронних листів у діалог — окреме завдання. Для пересилання через ingress Chatwoot потрібні MAILER_INBOUND_EMAIL_DOMAIN і RAILS_INBOUND_EMAIL_SERVICE, а також поштовий сервер, який передає вхідні повідомлення до Chatwoot. Можна також підключити поштову скриньку через IMAP, зокрема з OAuth для Google або Microsoft, не налаштовуючи цей шлях пересилання. Орендувати relay — найшвидший варіант. Якщо ви хочете самостійно керувати всім поштовим трактом, у матеріалі як запустити власний поштовий сервер на Mailcow описано, що саме передбачає таке рішення.

Що потрібно резервувати і як перевірити відновлення

Резервна копія Chatwoot складається з чотирьох частин. Якщо пропустити будь-яку з них, відновлення перетвориться на повторне розгортання.

  • База даних Postgres, у якій зберігаються розмови, контакти, облікові записи агентів і всі налаштування.
  • Том storage_data, оскільки ACTIVE_STORAGE_SERVICE=local записує завантажені файли на диск і зберігає в Postgres лише рядок із посиланням на файл.
  • Файл .env, оскільки в ньому зберігаються SECRET_KEY_BASE і ключі ACTIVE_RECORD_ENCRYPTION_*.
  • Файли compose, оскільки в них зафіксовано точний тег образу, якому відповідає схема бази даних.

Якщо відновити лише базу даних, усі розмови повернуться з непрацюючими вкладеннями, оскільки в рядках будуть посилання на файли, яких більше немає на диску.

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

Параметр -T має значення. Без нього Compose виділяє псевдотермінал, який змінює байти нового рядка у потоці. У результаті ви отримуєте файл дампа, який 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 робить недійсними всі cookies сеансів, тому всі користувачі вийдуть із системи. Відновлення з іншими ключами ACTIVE_RECORD_ENCRYPTION_* має серйозніші наслідки: Chatwoot не може розшифрувати стовпці з обліковими даними каналів і генерує ActiveRecord::Encryption::Errors::Decryption. Саме тому .env потрібно включати до резервної копії.

Як оновити Chatwoot до нового tag

Порядок дій важливіший за самі команди.

  1. Прочитайте примітки до релізів між вашим tag і цільовим tag та перевірте, чи потрібні додаткові ручні дії.
  2. Створіть свіжий дамп бази даних і архів сховища. Переконайтеся, що розміри обох файлів виглядають коректно.
  3. Змініть tag образу для сервісу base у docker-compose.yaml.
  4. Завантажте новий образ, зупиніть stack, виконайте міграції, а потім запустіть stack знову.
docker compose pull
docker compose down
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
docker compose images

Завантажте образ до запуску міграції, оскільки міграція має виконуватися з нового образу. Старий образ не містить нових файлів міграцій. Зупиніть stack перед міграцією, оскільки старий код і нова схема несумісні. Запущений процес Rails зі старого образу може генерувати помилки або записувати рядки, які нова схема не прийме. Зупинка також звільняє пам’ять, потрібну міграції. Саме тому upstream вимагає swap.

docker compose images виводить tag, з яким фактично запущено кожен контейнер. Це дає змогу виявити ситуацію, коли ви змінили tag, але забули завантажити новий образ.

Можливість пропустити проміжні версії залежить від віку інсталяції. Якщо інсталяція відстає на один або два релізи, перегляньте примітки до релізів між вашим tag і цільовим tag, укажіть цільовий tag і один раз виконайте наведені вище кроки. Лише для дуже старих інсталяцій Docker guide від upstream рекомендує послідовно оновлюватися через проміжні tag образів, а не переходити одразу на найновіший образ. У такому разі повторіть зміну tag, завантаження образу та крок підготовки для кожного проміжного tag, оскільки upstream вимагає виконувати db:chatwoot_prepare після кожного оновлення.

Якщо Rails запускається до виконання міграції, він відмовляється обслуговувати запити та записує в журнал ActiveRecord::PendingMigrationError: Migrations are pending. Якщо встановлено restart: always, контейнер переходить у цикл перезапусків, тому docker compose ps показує час роботи, який скидається кожні кілька секунд. Виконайте крок підготовки, і ця проблема зникне.

Відкат означає повернення старого tag і відновлення дампу. Надійного шляху для зворотної міграції немає. Саме для цього потрібен крок 2.

Несправності та повідомлення, які ви побачите

502 Bad Gateway від Traefik. Маршрутизатор спрацював, але бекенд не відповів. Перевірте, чи docker compose ps показує rails як Up, потім виконайте docker network inspect proxy і переконайтеся, що контейнер rails є у списку контейнерів. Контейнер, не підключений до мережі, невидимий для Traefik. Тому запит відповідає маршрутизатору, але далі не надходить до жодного сервісу.

Панель керування завантажується, але для появи нових повідомлень потрібно оновити сторінку. WebSocket-з’єднання з /cable не проходить, або FRONTEND_URL не відповідає адресі в адресному рядку браузера. Невідповідність означає, що сторінка намагається відкрити WebSocket-з’єднання з іншим origin, яке браузер блокує.

FATAL: password authentication failed for user "postgres". Пароль у .env відрізняється від пароля, збереженого у томі даних Postgres. Виправте його за допомогою ALTER USER у запущеному контейнері, оскільки повторне редагування .env не змінить уже ініціалізовану базу даних.

NOAUTH Authentication required. Redis працює з --requirepass, але застосунок підключився без пароля. Отже, REDIS_PASSWORD відсутній у .env або його значення не було застосовано. Безпосередньо перевірте пароль, який очікує Redis, за допомогою docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping'. Команда має повернути PONG. Одинарні лапки важливі: вони дають змогу розгорнути змінну всередині контейнера, де читається .env, а не у вашій власній оболонці, де ця змінна зазвичай порожня.

Контейнери завершуються з кодом 137. Це сигнал SIGKILL. На невеликому сервері його зазвичай надсилає механізм ядра, який завершує процеси через нестачу пам’яті, але docker kill надсилає той самий сигнал. Тому перед висновком про нестачу пам’яті перевірте sudo dmesg -T | grep -i "killed process". Якщо проблема в пам’яті, додайте swap, установіть обмеження пам’яті для окремих сервісів або перейдіть на більший тарифний план.

FAQ

Скільки RAM потрібно self-hosted Chatwoot VPS?

Станом на October 2026 upstream вимагає щонайменше 4 GB RAM і 4 CPU cores для навантаження до 10,000 розмов на день, а для 20,000 — 8 GB і 8 cores. Додайте щонайменше 1 GB swap, оскільки під час оновлення запускається другий процес Rails для застосування міграцій, і саме тоді на невеликих VPS закінчується пам’ять. VPS із 2 GB завантажується та працює для кількох агентів, але лише Sidekiq під навантаженням може використати понад 1 GB. Тому під час пікових періодів і оновлень очікуйте завершення контейнерів із exit code 137.

Чому листи для скидання пароля Chatwoot не надходять?

Тому що SMTP_ADDRESS не задано. У такому разі Chatwoot використовує доставку через sendmail, яка в upstream передбачає встановлений на хості сервер Postfix, а в цій Docker-конфігурації його немає. Завдання виконується в Sidekiq, тому помилка доставки потрапляє до журналу 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 у compose-файлі, а потім виконайте docker compose pull, docker compose down, docker compose run --rm rails bundle exec rails db:chatwoot_prepare і docker compose up -d. Спочатку виконайте pull, оскільки міграції мають запускатися з нового image. Спочатку зупиніть stack, оскільки старий код у разі роботи з новою схемою спричиняє помилки. Лише дуже стара інсталяція потребує послідовного переходу через проміжні теги image, а не прямого переходу на останню версію; після кожного переходу виконуйте prepare step.

Чи можна використовувати стандартний image postgres замість pgvector?

Ні. Схема Chatwoot вмикає розширення vector, тому стандартний image postgres завершується помилкою під час db:chatwoot_prepare із повідомленням ERROR: extension "vector" is not available, оскільки в цьому image немає control file розширення. Залиште pgvector/pgvector:pg16 з upstream compose-файлу або використовуйте інший image, який містить pgvector для вашої major version Postgres.

Чи була ця стаття корисною?

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