Instalacja Chatwoot przez Docker Compose

Ten przewodnik dotyczy oddzielnego serwera dla Chatwoot. Przykładowa domena to support.example.com. Przed pracą wybierz konkretny tag wydania i sprawdź jego plik Compose, zależności oraz notatki migracyjne.

Przygotuj środowisko

Potrzebujesz Dockera z wtyczką Compose, domeny, HTTPS, miejsca na dane i konfiguracji poczty. Dobierz zasoby do liczby agentów, ruchu, plików i używanych funkcji. Użyj plików .env.example oraz docker-compose.production.yaml z tego samego tagu oficjalnego repozytorium; gałąź rozwojowa może wyprzedzać wydanie.

Zapisz je jako .env i docker-compose.yaml w prywatnym katalogu instalacji. Sprawdź obrazy i usługi przed uruchomieniem. W obu procesach aplikacji, web i worker, zastosuj ten sam tag. Dla Community sprawdź odpowiadający mu obraz z końcówką -ce.

Ustaw dane i adres publiczny

Uzupełnij adres HTTPS w FRONTEND_URL, dane PostgreSQL i Redis oraz sekrety wymagane przez wybrane wydanie. Hasła usług muszą zgadzać się z konfiguracją Compose. Skonfiguruj SMTP i trwały magazyn załączników. Ogranicz dostęp do .env; nie zapisuj go w publicznym repozytorium.

Przygotuj bazę i uruchom usługi

W katalogu z zatwierdzonym plikiem Compose wykonaj:

docker compose config --quiet
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
docker compose ps

Nie publikuj wyniku pełnego docker compose config, ponieważ może zawierać rozwinięte sekrety. Nazwy usług w przykładzie odpowiadają szablonowi producenta; porównaj je ze swoim plikiem.

HTTPS i test odbiorczy

Publicznie udostępnij reverse proxy z TLS. Port aplikacji pozostaw przypisany do localhost, zgodnie z szablonem. Proxy musi obsługiwać WebSocket oraz właściwe nagłówki przekazywanego protokołu.

Sprawdź logowanie, zapis testowej rozmowy, aktualizacje wiadomości bez odświeżania, załącznik i kontrolowaną wysyłkę e-mail. Zweryfikuj działanie workerów i trwałość danych po restarcie. Przed otwarciem ruchu ustal zasady rejestracji i dostęp administratorów.

Utrzymanie

Wykonaj backup i próbę odtworzenia. Aktualizacje wymagają przeczytania instrukcji dla wybranego tagu i migracji bazy. Sam powrót do poprzedniego obrazu nie cofa migracji danych.