SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

Docker सह VPS वर Chatwoot self-host कसे करावे

Docker Compose आणि Traefik वापरून VPS वर Chatwoot तैनात करा. Pinned tags, प्रत्यक्ष mail पाठवणारे SMTP, Postgres व uploads backups आणि सुरक्षित upgrades जाणून घ्या.

तुम्ही काय तयार करत आहात

VPS वर Chatwoot self-host करण्यासाठी तुम्ही चार containers चालवता: Rails web process, Sidekiq background worker, pgvector extension असलेले PostgreSQL आणि Redis. Chatwoot हे open source customer support desk आहे. त्यामुळे तुमच्या नियंत्रणाखालील server वर shared team inbox आणि website chat widget मिळतो. Installation सुमारे वीस मिनिटे घेते. त्यानंतरचे mail delivery, backups, upgrades आणि sizing हे सर्व system एक वर्षानंतरही चालू राहील की नाही हे ठरवतात.

प्रत्येक container चे एक काम आहे. Rails agent dashboard आणि widget API (application programming interface) उपलब्ध करून देतो. Sidekiq धीमी कामे चालवतो: email पाठवणे, जोडलेल्या channels चे polling करणे, automation rules चालवणे आणि reports तयार करणे. Postgres मध्ये conversations, contacts, agent accounts आणि dashboard मध्ये तुम्ही बदललेली प्रत्येक setting साठवली जाते. Redis मध्ये Sidekiq queues आणि ActionCable pub/sub channel साठवला जातो. हा channel page reload न करता उघडलेल्या dashboard मध्ये नवीन message पाठवतो. येथे Redis हा सहज टाकून देता येणारा cache नाही, कारण तो गमावल्यास queued jobs गमावतात.

Upstream compose file मधील Postgres image ही stock postgres image ऐवजी pgvector/pgvector:pg16 आहे, कारण Chatwoot च्या schema मध्ये त्याच्या AI features साठी vector extension सक्षम केलेली आहे. Stock Postgres वापरल्यास पहिल्या database run वेळी ERROR: extension "vector" is not available मुळे प्रक्रिया थांबते, कारण त्या image मध्ये extension ची control file नसते. Upstream कडून releases होणारी image वापरा.

या मार्गदर्शकात Docker आणि reverse proxy server वर आधीपासून कार्यरत आहेत असे गृहीत धरले आहे. ते कार्यरत नसल्यास VPS वर Docker Compose पासून सुरुवात करा आणि नंतर येथे परत या.

self-hosted Chatwoot साठी किती VPS आवश्यक आहे?

ऑक्टोबर 2026 पर्यंत upstream requirements पृष्ठावर किमान 4 GB RAM आणि 4 CPU cores आवश्यक असल्याचे नमूद आहे. या क्षमतेवर दररोज 10,000 पर्यंत conversations हाताळता येतात. त्याच पृष्ठानुसार 8 GB RAM आणि 8 cores असल्यास दररोज 20,000 पर्यंत conversations हाताळता येतात. किमान 1 GB swap देखील आवश्यक आहे. कारण स्पष्ट दिले आहे: upgrade दरम्यान machine ची memory संपून जाऊ नये. File uploads धरून न ठेवता, Postgres साठी 5 GB ते 10 GB disk space राखून ठेवा.

आता थेट मुद्दा. 2 GB VPS वर Chatwoot सुरू होईल आणि दोन agents व कमी activity असलेल्या inbox मध्ये ते व्यवस्थित दिसेल. मात्र दोन परिस्थितींमध्ये ते अडचणीत येते. पहिली म्हणजे Sidekiq. Upstream च्या मोजमापानुसार busy server वर Sidekiq 1 GB पेक्षा अधिक memory वापरतो. त्यामुळे email चा burst किंवा report job आल्यावर Rails, Postgres आणि Redis यांचा memory वापर मोजण्यापूर्वीच machine ची memory संपते. दुसरी परिस्थिती म्हणजे upgrade. कारण db:chatwoot_prepare migrations लागू करण्यासाठी नवीन Rails process सुरू करते. या image वर Rails सुरू होण्यासाठी कोणतेही उपयुक्त काम करण्यापूर्वीच शेकडो megabytes memory लागतात.

सुरुवातीला कोणतीही स्पष्ट warning मिळत नाही. Kernel चा out of memory killer निवडलेल्या process ला, सामान्यतः सर्वाधिक memory वापरणाऱ्या process ला, SIGKILL पाठवतो. Docker ला container बंद झाल्याचे दिसते आणि restart: always तो पुन्हा सुरू करते. docker compose ps --all नंतर सतत restart होणारा container दाखवते किंवा तो Exited (137) स्थितीत दिसतो. येथे 137 म्हणजे signal 9 मुळे process बंद झाल्याचे दर्शवते. --all वगळल्यास थांबलेला container अजिबात सूचीबद्ध होत नाही. केवळ exit code 137 असल्याने memory हेच कारण होते असे सिद्ध होत नाही, कारण docker kill देखील तोच signal पाठवते. त्यामुळे sudo dmesg -T | grep -i "killed process" वापरून खात्री करा; ते kernel ने निवडलेल्या process चे नाव दाखवते.

4 GB चा खर्च शक्य नसल्यास, 2 GB ची machine 2 GB swap सह चालवा आणि load वाढल्यावर response times खराब होतील हे स्वीकारा. Swap हा memory संपण्यापासून बचाव करणारा buffer आहे; तो हमी नाही. त्यामुळे पुरेसा मोठा burst आल्यास container तरीही बंद होऊ शकतो. प्रत्येक service साठी hard memory ceiling निश्चित करणे कोणत्याही परिस्थितीत उपयुक्त आहे. त्यामुळे worker मुळे database देखील बंद पडणार नाही. Docker Compose मधील memory limits पहा.

File uploads हा तुम्ही निश्चित केलेली मर्यादा नसताना वाढत राहणारा भाग आहे. Customer ने attach केलेला प्रत्येक screenshot storage volume मध्ये साठतो आणि तिथेच राहतो. त्यामुळे disk database मुळे भरला असे गृहीत न धरता docker system df -v वर लक्ष ठेवा.

Compose file मिळवा आणि 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

तुम्ही नुकतीच download केलेली file 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 त्या सकाळी publish केलेली कोणतीही आवृत्ती देते. त्यात तुम्ही कधीही वाचलेले नसलेले migrations असलेली major version असू शकते. Chatwoot migrations प्रत्यक्ष वापरात reversible नसतात. त्यामुळे चुकून झालेली version jump undo करता येत नाही; backup restore करावा लागतो. Tag निश्चित करा आणि तो जाणीवपूर्वक बदला. 25 October 2026 रोजी v4.19.1 ही current release होती. Latest security fixes आणि hardening improvements साठी तिची शिफारस release notes मध्ये केली आहे. आज कोणता tag निश्चित करायचा हे पाहण्यासाठी releases page तपासा. तुम्ही v4.18.0 किंवा त्यापूर्वीच्या आवृत्तीवरून upgrade करत असल्यास, आधी v4.19.0 च्या notes वाचा: Captain V1 retire केले आहे. V1 instructions वापरणाऱ्या self-hosted installations ने upgrade करण्यापूर्वी V2 वर migrate करणे आवश्यक आहे. Database सांभाळणाऱ्या कोणत्याही application साठी हीच काळजी लागू होते. म्हणूनच openGym workout tracker self-host करणे याची सुरुवात git tag निश्चित करण्यापासून होते, जरी हे application यापेक्षा खूपच लहान असले तरी.

base service हा YAML anchor आहे. rails आणि sidekiq दोन्ही तो merge करतात. त्यामुळे tag एका ठिकाणी बदलल्यास तो दोन्हींसाठी बदलतो. File मध्ये असताना वरची version: '3' line delete करा. Modern Compose तिच्याकडे दुर्लक्ष करते आणि प्रत्येक command वर the attribute 'version' is obsolete, it will be ignored print करते.

.env फाइल भरा

प्रथम secret तयार करा. Upstream ला alphanumeric value अपेक्षित आहे, कारण ही value shell किंवा YAML parser मधून जाताना special characters चे स्वरूप बदलू शकतात.

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

त्यानंतर .env मध्ये या keys सेट करा.

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 service names आहेत. त्या project च्या default network वर resolve होतात. FRONTEND_URL केवळ सजावटीसाठी नाही. Chatwoot त्यावरून widget script URL आणि outgoing email मधील प्रत्येक link तयार करते. त्यामुळे चुकीची value दिल्यास password reset links प्रतिसाद न देणाऱ्या host कडे निर्देश करतात.

आता upstream फाइलमधील महत्त्वाचा अडथळा पाहू. postgres service .env वाचत नाही. तिच्यामध्ये स्वतःचा environment block आहे आणि POSTGRES_PASSWORD= रिक्त ठेवलेले आहे. त्यामुळे केवळ .env मध्ये password सेट केल्यास database कडे password नसतो, पण application कडे password असतो. Service ला त्याच 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}

Compose project directory मधून .env वाचते आणि ${...} substitution करते. त्यामुळे आता दोन्ही बाजूंना समान string मिळते. हे चुकीचे केल्यास Rails PG::ConnectionBad: FATAL: password authentication failed for user "postgres" सह थांबते.

एक वर्तन जवळपास सर्वांनाच आश्चर्यचकित करते: Postgres image POSTGRES_PASSWORD फक्त रिक्त data directory initialize करताना लागू करते. नंतर value बदलल्यास त्याचा परिणाम होत नाही, कारण initdb पुन्हा चालत नाही. Stack आधीच एकदा सुरू केला असल्यास database मध्येच ती value बदला.

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

ENABLE_ACCOUNT_SIGNUP=true तात्पुरते आहे. पहिला account तयार करण्यासाठी ते public registration form उघडते. तुमचा account तयार होताच ते false वर सेट करा आणि docker compose up -d पुन्हा चालवा. अन्यथा URL सापडलेली कोणतीही व्यक्ती तुमच्या support desk वर register करू शकते. त्यानंतर agents invitation द्वारे जोडले जातात आणि त्यांचे passwords फक्त या एका app मध्ये ठेवले जातात. अनेक services चालवताना प्रत्येकामध्ये स्वतंत्र account list ठेवणे त्रासदायक होईपर्यंत ही रचना योग्य आहे. त्या वेळी Authentik सारखा self-hosted identity provider या स्वतंत्र account lists ची जागा घेतो.

.env मध्ये आता या stack मधील प्रत्येक secret plain text मध्ये आहे. त्यामुळे फाइलचा mode 600 ठेवा आणि ती git मध्ये commit करू नका. Compose env files कशा वाचते आणि secrets कुठे उघड होतात या विषयात env_file आणि environment मधील फरकासह महत्त्वाच्या धोक्यांचे स्पष्टीकरण दिले आहे.

तुमच्या विद्यमान Traefik च्या मागे Chatwoot ठेवा

एका अॅप्लिकेशनसाठी दुसरा reverse proxy तयार करू नका. या सर्व्हरवरील इतर कंटेनरसाठी Traefik आधीच TLS (transport layer security) termination करत असेल, तर Chatwoot label block द्वारे त्यात जोडता येतो. तुमच्याकडे ही रचना अद्याप नसेल, तर अनेक Docker Compose अॅप्सच्या पुढे Traefik एकदा सेट करा आणि नंतर येथे परत या.

Upstream चे docker-compose.yaml जवळपास मूळ स्वरूपात ठेवा, जेणेकरून नंतरच्या नवीन प्रतीशी त्याची diff तुलना करता येईल. तुमचे बदल override फाइलमध्ये ठेवा. Compose docker-compose.override.yaml आपोआप merge करते आणि Compose अनेक फाइल्समध्ये विभागणे 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

तुमची entrypoint आणि certresolver नावे वापरा. कंटेनर Traefik च्या समान Docker network वर असणे आवश्यक आहे. proxy entry हेच सुनिश्चित करते. तसेच ते default वरही राहिले पाहिजे; अन्यथा Postgres आणि Redis शी त्याचा संपर्क तुटतो. ही दुसरी ओळ अनेकदा विसरली जाते.

ports: block मध्ये बदल करू नका. Upstream ते 127.0.0.1:3000 शी bind करते. हा फक्त loopback साठी उपलब्ध असल्यामुळे इंटरनेटवरून त्याच्यापर्यंत पोहोचता येत नाही. सर्व्हरच्या आतून curl -I http://127.0.0.1:3000 वापरून चाचणी करण्यासाठी ते उपयुक्त राहते.

Live message delivery साठी agent dashboard /cable शी websocket connection उघडे ठेवते. Traefik कोणत्याही अतिरिक्त configuration शिवाय HTTP upgrade forward करते, त्यामुळे काहीही जोडण्याची गरज नाही. नंतर Traefik च्या पुढे CDN किंवा दुसरा proxy ठेवला, तर तेथे websockets ला अनुमती द्या. अन्यथा dashboard सामान्यपणे load होईल, पण नवीन संदेश फक्त manually refresh केल्यानंतर दिसतील.

डेटाबेस सुरू करा आणि stack सुरू करा

प्रथम data services सुरू करा आणि Postgres चा पहिला run पूर्ण होऊ द्या.

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

यामुळे database उपलब्ध नसल्यास तो तयार होतो. त्यानंतर schema आणि default seed data लोड होतो. Migration ओळी मुद्रित होतात आणि command स्वच्छपणे बंद होते. जर postgres:5432 - no response मुद्रित होत राहिले, तर entrypoint अद्याप connections स्वीकारत नसलेल्या database ची प्रतीक्षा करत आहे. पहिल्या run मध्ये याचा अर्थ सहसा initdb चे काम सुरू आहे. प्रतीक्षा करा, Postgres logs वाचा आणि command पुन्हा चालवा. जर vector extension वर प्रक्रिया थांबली, तर तुम्ही pgvector image ऐवजी stock Postgres वापरले आहे.

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

चारही containers ची स्थिती Up अशी असावी. rails log चा शेवट http://0.0.0.0:3000 वर listening करणाऱ्या Puma ओळीने झाला पाहिजे. त्यानंतर public path तपासा:

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

HTTP/2 200 याचा अर्थ संपूर्ण chain कार्यरत आहे. Traefik कडून 404 मिळाल्यास router rule जुळलेली नाही. याचे सामान्य कारण hostname मधील टंकलेखनाची चूक असते. 502 मिळाल्यास Traefik ने router जुळवला आहे, परंतु container पर्यंत पोहोचता आलेले नाही. याचे जवळजवळ नेहमीचे कारण म्हणजे proxy network नसणे किंवा loadbalancer.server.port चे मूल्य 3000 नसणे.

URL उघडा, /app/auth/signup येथे तुमचे account तयार करा, त्यानंतर ENABLE_ACCOUNT_SIGNUP=false सेट करा आणि form बंद करण्यासाठी docker compose up -d चालवा.

SMTP शिवाय पासवर्ड रीसेट आणि ईमेल संभाषणे का अपयशी ठरतात

SMTP (simple mail transfer protocol) settings नसलेले Chatwoot हे ईमेल पाठवू न शकणारे support desk आहे. त्यामुळे केवळ notificationsच बंद होत नाहीत. पासवर्ड रीसेट काम करणे थांबवतात. त्यामुळे admin account मधून lock out झालेला administrator पुन्हा प्रवेश मिळवू शकत नाही. Agent invitations काम करणे थांबवतात, कारण invitation ईमेलद्वारे पाठवले जाते. ईमेल संभाषणातील ग्राहकाला reply पाठवणेही थांबते. त्यामुळे संभाषण फक्त एका दिशेने चालते. ही पायरी लोक अनेकदा वगळतात आणि नंतर सर्वाधिक गरज असताना ही समस्या लक्षात येते.

यामागील प्रक्रिया सरळ आहे. SMTP_ADDRESS सेट केलेले नसल्यास Chatwoot ActionMailer ला sendmail delivery वापरण्यास सांगते. Upstream documentation मध्ये याला Postfix setup म्हटले आहे. v2.12.0 पासून हे default आहे. त्यातील सूचनांनुसार sudo apt install -y postfix वापरून server वर Postfix install करावा लागतो. या Docker setup मध्ये तसे केलेले नाही. त्यामुळे delivery कडे ईमेल सुपूर्द करण्यासाठी configured mail server उपलब्ध नसतो. ईमेल background job मधून पाठवले जाते. त्यामुळे delivery मुळे निर्माण झालेली कोणतीही error Sidekiq log मध्ये जाते; Rails log मध्ये जात नाही. दरम्यान, "forgot password" वर click करणाऱ्या व्यक्तीला यशस्वी झाल्याची सूचना दिसते; पण तिला ईमेल मिळत नाही.

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

STARTTLS सह port 587 वापरा. यात connection सुरुवातीला plain text मध्ये उघडते आणि authentication करण्यापूर्वी encrypted केले जाते. Spam मर्यादित करण्यासाठी अनेक VPS providers outbound port 25 default ने block करतात. 8 November 2026 रोजीच्या स्थितीनुसार, Hetzner cloud servers वर ports 25 आणि 465 default ने block करते. हे blocking प्रत्येक account साठी लागू केले जाते. Vultr सर्व नवीन Compute Instances वर port 25 block करते. दोन्ही providers unblock requests प्रकरणानुसार तपासतात. Limit request सादर करण्यापूर्वी Hetzner कडे customer म्हणून एक महिना पूर्ण झालेला असावा आणि पहिला invoice भरलेला असावा. दोघेही port 587 block करत नाहीत. त्यामुळे ticket किंवा प्रतीक्षा न करता पहिल्या boot पासून port 587 वरील relay काम करते. SMTP_DOMAIN म्हणजे SMTP conversation दरम्यान तुमचा server ज्या domain ची घोषणा करतो तो domain. काही relays mismatch असल्यास request नाकारतात.

Settings लागू करा आणि worker चे निरीक्षण करा:

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

Login page वरून password reset सुरू करा. Delivery कार्यरत असल्यास Sidekiq log मध्ये mailer job सामान्यपणे पूर्ण झाल्याचे दिसते. Failure झाल्यास प्रथम exception class दिसते. त्यानंतर Sidekiq वाढत्या backoff सह retry करते. त्यामुळे broken relay मुळे तोच error अनेक तास दर काही मिनिटांनी दिसतो.

दोन प्रकारचे rejections सामान्य आहेत. यापैकी कोणतेही Chatwoot bug नाही. 535 Authentication failed म्हणजे authentication अयशस्वी झाले आहे. त्यामुळे credentials, SMTP authentication enabled आहे का आणि access policy त्याला block करते का हे तपासा. फक्त credentials योग्य असल्याने हा error नाकारता येत नाही. काही providers account password ऐवजी application password आवश्यक करतात. 550 Sender address rejected म्हणजे server ने sender address नाकारला आहे. MAILER_SENDER_EMAIL बदलण्यापूर्वी पूर्ण response वाचा. Sender permissions किंवा verification हे एक कारण असू शकते. मात्र 550 5.7.27 Sender address rejected: Domain does not accept mail असल्यास sender domain साठी null MX record आहे.

Conversation मध्ये ईमेल प्राप्त करणे हे स्वतंत्र काम आहे. Chatwoot च्या ingress मार्फत forwarding करण्यासाठी MAILER_INBOUND_EMAIL_DOMAIN आणि RAILS_INBOUND_EMAIL_SERVICE आवश्यक आहेत. तसेच incoming messages Chatwoot कडे सुपूर्द करणारा mail server आवश्यक आहे. Forwarding path configure न करता IMAP मार्फत mailbox जोडू शकता. यामध्ये Google किंवा Microsoft OAuth देखील वापरता येतो. Relay भाड्याने घेणे हा जलद मार्ग आहे. संपूर्ण mail path स्वतः व्यवस्थापित करायचा असल्यास, Mailcow सह स्वतःचा mail server चालवणे या प्रक्रियेत प्रत्यक्षात कोणत्या जबाबदाऱ्या येतात हे स्पष्ट केले आहे.

कशाचा बॅकअप घ्यावा आणि restore कार्यरत असल्याचे कसे सिद्ध करावे

Chatwoot बॅकअपचे चार भाग असतात. यापैकी कोणताही भाग वगळल्यास restore करण्याऐवजी संपूर्ण सेवा पुन्हा उभारावी लागते.

  • Postgres database, ज्यामध्ये conversations, contacts, agent accounts आणि प्रत्येक setting साठवलेली असते.
  • storage_data volume, कारण ACTIVE_STORAGE_SERVICE=local अपलोड केलेल्या files disk वर लिहिते आणि Postgres मध्ये फक्त reference row ठेवते.
  • .env file, कारण त्यामध्ये SECRET_KEY_BASE आणि ACTIVE_RECORD_ENCRYPTION_* keys असतात.
  • compose files, कारण त्यामध्ये database schema शी जुळणारा अचूक image tag नोंदवलेला असतो.

फक्त database restore केल्यास सर्व conversations परत येतात; परंतु प्रत्येक attachment तुटलेला असतो, कारण त्या rows ज्या files कडे निर्देश करतात त्या disk वर उपलब्ध नसतात.

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

-T महत्त्वाचे आहे. ते नसल्यास Compose pseudo terminal allocate करते. त्यामुळे stream मधील newline bytes बदलतात आणि pg_restore नाकारणारी dump file तयार होते. -Fc हा custom format आहे. तो compression करतो आणि pg_restore ला निवडकपणे काम करू देतो.

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

Volume चे नाव तुमच्या project directory च्या नावासोबत _storage_data जोडून तयार होते. त्या command वर विश्वास ठेवण्यापूर्वी docker volume ls | grep storage_data ने त्याची खात्री करा. अस्तित्वात नसलेले volume नाव दिल्यास Docker अपयशी ठरत नाही; त्याऐवजी ते रिकामे volume तयार करते. त्यामुळे वैध पण रिकामे archive तयार होईल आणि कोणतीही error दिसणार नाही. त्यानंतर ls -lh storage-*.tgz ने त्याचा size तपासा.

आता दोन्ही files त्यांच्याद्वारे संरक्षित केलेल्या गोष्टीच्या त्याच disk वर आहेत. त्यामुळे तुमचे संरक्षण होत नाही. त्या server बाहेर पाठवा आणि encrypt करा, कारण database dump मध्ये प्रत्येक customer message plain text मध्ये असतो. restic सह encrypted off-site backups या लेखात scheduling आणि retention पद्धत स्पष्ट केली आहे.

Restore drill: गरज पडण्यापूर्वी चालवून पाहा

Live server वर restore करू नका. दुसऱ्या VPS वर restore करा. .env, compose files आणि दोन्ही archives तेथे copy करा आणि नंतर हे चालवा:

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 loading करण्यापूर्वी विद्यमान objects काढून टाकते. त्यामुळे ती फक्त अशा database वर वापरा जी गमावण्यास तुम्ही तयार आहात. त्यानंतर sign in करा आणि attachment असलेले conversation उघडा. Message list load झाली आणि file download झाली, तर बॅकअप वास्तविक आहे.

वेगळ्या SECRET_KEY_BASE सह केलेल्या restore मुळे प्रत्येक session cookie अवैध होते आणि सर्वजण sign out होतात. वेगळ्या ACTIVE_RECORD_ENCRYPTION_* keys सह केलेला restore अधिक गंभीर आहे: Chatwoot channel credentials असलेले columns decrypt करू शकत नाही आणि ActiveRecord::Encryption::Errors::Decryption दाखवते. म्हणूनच .env बॅकअपच्या यादीत आहे.

Chatwoot ला नवीन tag वर upgrade कसे करावे

Commands पेक्षा त्यांचा क्रम अधिक महत्त्वाचा आहे.

  1. तुमच्या tag आणि target tag मधील release notes वाचा आणि आवश्यक manual steps शोधा.
  2. नवीन database dump आणि storage archive तयार करा. दोन्ही फाइल्सचे आकार योग्य आहेत का ते तपासा.
  3. docker-compose.yaml मधील base service साठी image tag बदला.
  4. नवीन image pull करा, 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

Migration चालवण्यापूर्वी image pull करा, कारण migration नवीन image मधूनच चालवावी लागते. जुन्या image मध्ये नवीन migration files नसतात. Migration चालवण्यापूर्वी stack थांबवा, कारण जुना code आणि नवीन schema यांच्यात विसंगती असते. त्यामुळे चालू असलेली जुनी Rails process errors निर्माण करू शकते किंवा नवीन schema स्वीकारणार नाही अशा rows लिहू शकते. Stack थांबवल्यामुळे migration साठी आवश्यक memory मोकळी होते. Swap मागण्याचे हेच कारण आहे.

docker compose images प्रत्येक container सध्या कोणता tag चालवत आहे ते दाखवते. त्यामुळे tag बदलून pull करायचे विसरल्याचे प्रकरण लक्षात येते.

तुम्ही किती मोठी version उडी घेऊ शकता हे installation किती जुनी आहे यावर अवलंबून असते. Installation एक किंवा दोन releases ने मागे असल्यास, तुमच्या tag आणि target tag मधील release notes तपासा, target tag सेट करा आणि वरील steps एकदाच चालवा. Installation खूप जुनी असल्यासच upstream च्या Docker guide नुसार थेट latest image वर जाण्याऐवजी intermediate image tags मधून क्रमाने upgrade करावे लागते. अशा वेळी प्रत्येक intermediate tag साठी tag बदलणे, pull करणे आणि prepare step चालवणे पुन्हा करा, कारण प्रत्येक upgrade नंतर upstream db:chatwoot_prepare मागते.

Migration चालण्यापूर्वी Rails सुरू झाल्यास ते serve करण्यास नकार देते आणि ActiveRecord::PendingMigrationError: Migrations are pending log करते. restart: always सेट असल्यास container पुन्हा पुन्हा सुरू होते. त्यामुळे docker compose ps काही सेकंदांनी reset होणारा uptime दाखवते. Prepare step चालवा. त्यानंतर ही समस्या दूर होते.

Rollback करण्यासाठी जुना tag पुन्हा सेट करा आणि dump restore करा. विश्वास ठेवता येईल असा reverse migration path उपलब्ध नाही. म्हणूनच step 2 महत्त्वाचा आहे.

अपयशाच्या स्थिती आणि तुम्हाला दिसणारे संदेश

Traefik कडून 502 Bad Gateway. Router जुळला, पण backend ने उत्तर दिले नाही. docker compose ps मध्ये rails हे Up म्हणून दिसते का ते तपासा. त्यानंतर docker network inspect proxy चालवा आणि कंटेनरच्या यादीत rails container दिसतो का ते पडताळा. जोडलेला नसलेला container Traefik ला दिसत नाही. त्यामुळे विनंती router शी जुळते, पण पुढे कुठेही पोहोचत नाही.

Dashboard लोड होते, पण नवीन संदेश पाहण्यासाठी refresh करावे लागते. /cable कडे जाणारे websocket connection पुढे जात नाही किंवा FRONTEND_URL ब्राउझरच्या address bar मधील पत्त्याशी जुळत नाही. पत्ते जुळले नाहीत, तर page वेगळ्या origin कडे websocket उघडण्याचा प्रयत्न करते. ब्राउझर ते अवरोधित करतो.

FATAL: password authentication failed for user "postgres". .env मधील password आणि Postgres data volume मध्ये आधीपासून समाविष्ट असलेला password वेगळा आहे. चालू container मध्ये ALTER USER वापरून तो दुरुस्त करा. .env पुन्हा संपादित केल्याने आधीच initialize केलेला database बदलत नाही.

NOAUTH Authentication required. Redis --requirepass सह चालू आहे, पण application password शिवाय connect झाले आहे. त्यामुळे REDIS_PASSWORD हे .env मधून गहाळ आहे किंवा ते स्वीकारले गेलेले नाही. Redis ला अपेक्षित असलेला password थेट docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping' वापरून तपासा. त्यावर PONG असे उत्तर मिळायला हवे. Single quotes महत्त्वाचे आहेत. त्यांमुळे variable तुमच्या स्वतःच्या shell मध्ये नव्हे, तर container मध्ये expand होते. Container .env वाचतो; तुमच्या shell मध्ये ते सहसा रिकामे असते.

Code 137 सह containers बंद होणे. हा SIGKILL आहे. लहान server वर हा signal सहसा kernel मधील out of memory killer पाठवतो. मात्र docker kill हाच signal पाठवते. त्यामुळे memory ला कारणीभूत ठरवण्यापूर्वी sudo dmesg -T | grep -i "killed process" तपासा. Memory अपुरी असल्यास swap जोडा, प्रत्येक service साठी memory limits सेट करा किंवा मोठ्या plan वर स्थलांतर करा.

FAQ

self-hosted Chatwoot VPS साठी किती RAM आवश्यक आहे?

October 2026 पर्यंत, upstream किमान 4 GB RAM आणि 4 CPU cores मागते. ही क्षमता दररोज 10,000 conversations पर्यंतच्या वापरासाठी आहे. दररोज 20,000 conversations पर्यंतच्या वापरासाठी 8 GB RAM आणि 8 cores आवश्यक आहेत. किमान 1 GB swap जोडा, कारण upgrade दरम्यान migrations लागू करण्यासाठी दुसरी Rails process सुरू होते. याच वेळी लहान VPS मध्ये memory संपते. 2 GB VPS सुरू होते आणि दोन-तीन agents साठी कार्य करते. मात्र load असताना केवळ Sidekiq 1 GB पेक्षा जास्त memory वापरू शकते. त्यामुळे व्यस्त काळात आणि upgrades दरम्यान containers exit code 137 सह बंद होण्याची शक्यता गृहीत धरा.

Chatwoot चे password reset emails कधीच का पोहोचत नाहीत?

कारण SMTP_ADDRESS सेट केलेले नसते. त्यामुळे Chatwoot sendmail delivery वापरते. upstream नुसार यासाठी host वर Postfix server installed असणे अपेक्षित आहे. या Docker setup मध्ये Postfix नाही. Job Sidekiq मध्ये चालते. त्यामुळे delivery error Sidekiq log मध्ये नोंदवली जाते, तर browser मध्ये यशस्वी संदेश दिसत राहतो. .env मध्ये SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD आणि MAILER_SENDER_EMAIL सेट करा. त्यानंतर rails आणि sidekiq services restart करा. Reset सुरू करताना docker compose logs -f sidekiq monitor करा.

Chatwoot restore करण्यासाठी कोणत्या गोष्टींचा backup घ्यावा?

Postgres database, storage_data Docker volume, .env file आणि compose files यांचा backup घ्या. केवळ database पुरेसा नाही. Uploaded files volume मध्ये असतात, तर Postgres मध्ये त्यांचे फक्त references असतात. त्यामुळे केवळ database restore केल्यास attachments तुटलेल्या conversations मिळतात. .env महत्त्वाचे आहे, कारण वेगळे SECRET_KEY_BASE सर्व users ना sign out करते. वेगळ्या ACTIVE_RECORD_ENCRYPTION_* keys मुळे encrypted columns वाचता येत नाहीत.

Database बिघडू न देता Chatwoot upgrade कसे करावे?

Backup घ्या. तुमच्या tag पासून target पर्यंतच्या release notes वाचा. Compose file मधील image tag बदला. त्यानंतर docker compose pull, docker compose down, docker compose run --rm rails bundle exec rails db:chatwoot_prepare आणि docker compose up -d चालवा. प्रथम pull करा, कारण migrations नवीन image मधून चालणे आवश्यक आहे. Stack आधी stop करा, कारण नवीन schema वर जुना code चालवल्यास errors येतात. अतिशय जुन्या install साठीच intermediate image tags मधून क्रमाने upgrade करणे आवश्यक असते. अशा वेळी प्रत्येक tag नंतर prepare step चालवा. Latest वर थेट jump करू नका.

pgvector ऐवजी standard postgres image वापरता येईल का?

नाही. Chatwoot चे schema vector extension enable करते. त्यामुळे stock postgres image मध्ये db:chatwoot_prepare चालवताना ERROR: extension "vector" is not available येते. त्या image मध्ये extension ची control file उपलब्ध नसते. Upstream compose file मधील pgvector/pgvector:pg16 तसेच ठेवा. किंवा तुमच्या Postgres major version साठी pgvector उपलब्ध करून देणारी दुसरी image वापरा.

हा लेख उपयुक्त होता का?

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