Docker Compose के साथ Rocket.Chat कैसे होस्ट करें
Docker Compose का उपयोग करके अपने VPS पर Rocket.Chat को सेल्फ-होस्ट करना सीखें। MongoDB replica set की अनिवार्य आवश्यकता, TLS सेटअप और डेटा बैकअप की पूरी प्रक्रिया यहाँ समझें।
आप क्या बना रहे हैं
एक निजी टीम चैट जिस पर आपका पूर्ण स्वामित्व है: Rocket.Chat जो आपके अपने VPS पर Docker Compose के अंतर्गत चल रहा है, TLS द्वारा सुरक्षित है, और प्रत्येक संदेश एक MongoDB डेटाबेस में है जिसे आप बैकअप ले सकते हैं और स्थानांतरित कर सकते हैं। Rocket.Chat, Slack और Teams का एक परिपक्व ओपन-सोर्स विकल्प है, जिसमें चैनल, डायरेक्ट मैसेज, थ्रेड्स, फाइल शेयरिंग, और वॉयस व वीडियो कॉल की सुविधा है, जो आपके द्वारा किराए पर लिए गए और नियंत्रित हार्डवेयर पर चलता है। हालाँकि, यह एकमात्र विश्वसनीय विकल्प नहीं है, और यदि आप अभी भी चुनाव कर रहे हैं, तो Mattermost, Rocket.Chat, Synapse और Zulip की तुलना उन्हें उन पहलुओं पर परखती है जो बाद में समस्या पैदा करते हैं: RAM, डेटाबेस, मोबाइल पुश, SSO और अपग्रेड। यह एप्लिकेशन एक सिंगल कंटेनर है जो कुछ ही मिनटों में तैयार हो जाता है। जो कुछ भी वास्तव में गलत होता है वह इसके बगल में स्थित डेटाबेस में होता है, इसलिए इस गाइड का अधिकांश हिस्सा MongoDB के बारे में है, और विशेष रूप से उस एक आवश्यकता के बारे में जो पहली बार में सभी को आश्चर्यचकित करती है: Rocket.Chat एक स्टैंडअलोन MongoDB के साथ नहीं चलेगा। इसे एक replica set की आवश्यकता होती है, भले ही वह "सेट" केवल एक सिंगल नोड ही क्यों न हो।
आवश्यकताएँ, और RAM का वह गणित जो कोई नहीं बताता
सर्वर का आकार ईमानदारी से चुनें। एक छोटी टीम के लिए वास्तविक न्यूनतम आवश्यकता 2 vCPU और 4 GB RAM है। Rocket.Chat की Node.js प्रक्रिया को अकेले ही लगभग 1 से 1.5 GB RAM चाहिए होती है, और MongoDB का WiredTiger cache डिफ़ॉल्ट रूप से (कुल RAM में से 1 GB घटाकर) उसका 50% या 0.256 GB, जो भी अधिक हो, उपयोग करता है। यह डिफ़ॉल्ट मानकर चलता है कि mongod के पास पूरा मशीन उपलब्ध है: यह कुल RAM से गणना की जाती है और इस बात का ध्यान नहीं रखती कि Node पहले से ही कितनी RAM उपयोग कर रहा है। इसलिए, 4 GB वाले बॉक्स पर यह 1.5 GB और 2 GB वाले बॉक्स पर लगभग 0.5 GB हो जाता है, जो Node के heap, cache के बाहर mongod की अपनी मेमोरी और ऑपरेटिंग सिस्टम के उपयोग के अतिरिक्त है। 2 GB वाले VPS पर ये दोनों बूट के समय तो चल जाते हैं, लेकिन वास्तविक ट्रैफिक आते ही आपस में टकराते हैं: MongoDB अपना cache बढ़ाता है, Node अपना heap बढ़ाता है, kernel के पास pages खत्म हो जाते हैं, और out-of-memory killer सबसे बड़ी प्रक्रिया को बंद कर देता है, जो आमतौर पर mongod होती है। कंटेनर Killed प्रिंट करता है, Docker उसे restart करता है, और आपको एक ऐसा चैट सर्वर मिलता है जो उस लोड के नीचे बार-बार बंद हो जाता है जिसे उसे आसानी से झेलना चाहिए था। 2 GB का उपयोग केवल दो लोगों के साथ टेस्टिंग के लिए ठीक है; यह एक टीम सर्वर नहीं है। 4 GB से शुरुआत करें, और यदि आप दर्जनों concurrent users, वीडियो कॉल, या बढ़ते हुए अपलोड इतिहास की उम्मीद करते हैं, तो इसे 8 GB दें। बॉक्स पर चलने वाली अन्य चीजों के लिए भी बजट रखें: उसी VPS पर Notion-style AFFiNE workspace डालने से चार और कंटेनर जुड़ जाते हैं जो उन्हीं pages के लिए प्रतिस्पर्धा करते हैं, इसलिए उनकी RAM Rocket.Chat की RAM में से नहीं, बल्कि उसके अतिरिक्त होनी चाहिए।
शुरू करने से पहले आपके पास तीन चीजें तैयार होनी चाहिए। एक domain name जिसका A record VPS के public IP पर पॉइंट कर रहा हो; Rocket.Chat के real-time फीचर्स और मोबाइल क्लाइंट्स को एक स्थिर hostname चाहिए, न कि केवल एक IP। सर्वर firewall और आपके प्रदाता के network firewall (जो अधिकांश पैनलों में एक अलग नियंत्रण होता है) दोनों पर Ports 80 और 443 खुले होने चाहिए। और root या sudo एक्सेस के साथ एक नया Ubuntu 24.04 KVM VPS। यदि आप अभी भी यह तय कर रहे हैं कि क्या चैट सर्वर चलाना आपका पहला सही कदम है, तो 2026 में क्या self-host करना सार्थक है, इस पर गाइड ट्रेड-ऑफ को स्पष्ट करती है।
Docker engine और Compose plugin को install करें
Ubuntu द्वारा प्रदान किए गए docker.io पैकेज का उपयोग न करें, और न ही पुराने standalone docker-compose Python binary का उपयोग करें। इसके बजाय Docker के आधिकारिक apt repository का उपयोग करें। आधुनिक Compose एक Docker plugin है जिसे आप docker compose के रूप में invoke करते हैं (एक space के साथ, hyphen के बिना)। पुराना docker-compose v1 अब end-of-life हो चुका है, हालाँकि इसका अंतिम release, 1.29.2, नीचे उपयोग की गई service_healthy dependency condition का समर्थन करता है।
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginसुनिश्चित करें कि दोनों घटक मौजूद हैं:
sudo docker version
sudo docker compose versiondocker compose version द्वारा version line प्रिंट करना ही मुख्य जाँच है। वर्तमान releases Docker Compose version v5.x प्रिंट करते हैं (2026-10-10 तक, 2 अक्टूबर 2026 को release हुआ v5.6.0 नवीनतम था); पुराने install में अभी भी v2.x प्रिंट हो सकता है, और Docker दोनों का समर्थन करता है। Docker, Compose v5 को कार्यात्मक रूप से v2 के समान बताता है। इसे v5 इसलिए नाम दिया गया है ताकि legacy v2 और v3 compose file formats के साथ भ्रम न हो, इसलिए इस guide के लिए दोनों में से कोई भी संस्करण ठीक है। यदि यह docker: 'compose' is not a docker command error देता है, तो इसका मतलब है कि plugin install नहीं हुआ है और आपको बाद में भ्रमित करने वाली विफलताओं का सामना करना पड़ेगा, इसलिए इसे यहीं ठीक करें।
Compose file: MongoDB को single-node replica set के रूप में चलाना
यह वह हिस्सा है जहाँ लोग अक्सर गलती करते हैं, इसलिए इसे ध्यान से पढ़ें। Rocket.Chat वास्तविक समय में नए संदेश भेजने के लिए MongoDB change streams का उपयोग करता है। Change streams केवल replica sets और sharded clusters पर उपलब्ध होते हैं, standalone servers पर नहीं। यदि आप Rocket.Chat को एक साधारण standalone mongod से जोड़ेंगे, तो यह connect तो हो जाएगा, लेकिन change stream खोलने में विफल रहेगा और बार-बार restart होता रहेगा। इसका समाधान जटिल नहीं है: आप एक साधारण MongoDB container चलाएं, लेकिन उसे --replSet के साथ start करें और फिर एक-सदस्यीय (one-member) set को initialize करें।
एक working directory और एक compose.yml बनाएँ:
services:
mongodb:
image: mongo:8.0
restart: always
command: ["mongod", "--replSet", "rs0", "--bind_ip_all", "--oplogSize", "128"]
volumes:
- mongodb_data:/data/db
- mongodb_config:/data/configdb
healthcheck:
test: ["CMD", "mongosh", "--quiet", "--eval", "db.adminCommand('ping')"]
interval: 10s
timeout: 10s
retries: 12
rocketchat:
image: registry.rocket.chat/rocketchat/rocket.chat:8.5.1
restart: always
depends_on:
mongodb:
condition: service_healthy
environment:
MONGO_URL: "mongodb://mongodb:27017/rocketchat?replicaSet=rs0"
ROOT_URL: "https://chat.example.com"
PORT: "3000"
ports:
- "127.0.0.1:3000:3000"
volumes:
mongodb_data:
mongodb_config:यहाँ कुछ विकल्प जानबूझकर चुने गए हैं। Rocket.Chat port को 127.0.0.1:3000 पर publish किया गया है, 0.0.0.0 पर नहीं। App में स्वयं कोई TLS नहीं है, इसलिए केवल उसी box पर मौजूद reverse proxy को ही इसे access करना चाहिए; इसे हर interface पर bind करने से एक plaintext login page सीधे public internet पर आ जाएगा। MongoDB को host पर बिल्कुल भी publish नहीं किया गया है; यह केवल Compose के internal network पर mongodb नाम से ही पहुँच योग्य है, जो कि बिल्कुल वही hostname है जिसका उपयोग MONGO_URL करता है। MONGO_URL में ?replicaSet=rs0 शामिल है, जो set का नाम स्पष्ट रूप से बताता है; MongoDB drivers के बीच सुसंगत व्यवहार के लिए इसे set करने की सलाह देता है। इसे न छोड़ने से अपने आप कुछ भी खराब नहीं होता: directConnection डिफ़ॉल्ट रूप से false होता है, इसलिए driver अभी भी replica set को खोज लेता है और primary को operations भेजता है, बशर्ते set को ऐसे hostname के साथ शुरू किया गया हो जिसे Rocket.Chat resolve कर सके, जिसका ध्यान अगले भाग में रखा गया है। MONGO_OPLOG_URL को Rocket.Chat 8.0.0 में हटा दिया गया था, इसलिए इसे यहाँ शामिल नहीं किया गया है; Rocket.Chat इसके बजाय MongoDB change streams का उपयोग करता है। depends_on में condition: service_healthy का उपयोग किया गया है, इसलिए Compose तब तक प्रतीक्षा करता है जब तक MongoDB ping का उत्तर नहीं देता, उसके बाद ही Rocket.Chat start होता है; healthcheck का यही उद्देश्य है।
दोनों images पर वास्तविक version tags पिन करें, जैसे mongo:8.0 और Rocket.Chat का एक स्पष्ट release जैसे यहाँ 8.5.1 है। :latest का उपयोग करने से बचें, क्योंकि अगली बार container recreate करते समय यह अनपेक्षित version चुन सकता है। docker pull केवल image download करता है; इसे deploy करने के लिए एक और action की आवश्यकता होती है, जैसे docker compose up -d, और नया container start होने पर Rocket.Chat अपना migration चलाता है। पिन करने से पहले वर्तमान stable Rocket.Chat release और उसके द्वारा समर्थित MongoDB versions की जाँच करें। Rocket.Chat की support table में Rocket.Chat 8.x के लिए MongoDB 8.0 और उससे ऊपर का उल्लेख है, जिसे 8.2 के साथ verify किया गया है, इसलिए mongo:8.0 एक समर्थित विकल्प है, न कि एकमात्र समर्थित engine। 8.5.1 release notes इसे एक LTS build के रूप में पहचानते हैं। हर project versioned image प्रकाशित नहीं करता है, ऐसी स्थिति में पिन source पर चला जाता है: self-hosting the openGym workout tracker का अर्थ है किसी विशिष्ट git tag को checkout करना और moving branch का अनुसरण करने के बजाय उससे build करना।
Replica set को इनिशियलाइज़ करें
Stack को start करें:
sudo docker compose up -dRocket.Chat तुरंत क्रैश होना शुरू हो जाएगा और Docker इसे बार-बार restart करता रहेगा। यह अपेक्षित है, क्योंकि replica set अभी मौजूद नहीं है। इसे एक बार मैन्युअल रूप से बनाएँ:
sudo docker compose exec mongodb mongosh --eval 'rs.initiate({_id: "rs0", members: [{_id: 0, host: "mongodb:27017"}]})'सही परिणाम { ok: 1 } है। कुछ ही सेकंड में सिंगल नोड खुद को primary चुन लेगा; इसकी पुष्टि इस कमांड से करें:
sudo docker compose exec mongodb mongosh --quiet --eval 'rs.status().members[0].stateStr'आपको PRIMARY दिखाई देना चाहिए। इस पूरे पेज पर सबसे महत्वपूर्ण विवरण host: "mongodb:27017" आर्गुमेंट है। यदि आप बिना members लिस्ट के केवल rs.initiate() चलाते हैं, तो MongoDB replica set को कंटेनर के इंटरनल होस्टनेम (एक रैंडम हैश जैसे a1b2c3d4e5f6) के तहत एडवर्टाइज करता है। Rocket.Chat, जो अपने कंटेनर से कनेक्ट हो रहा है, उस नाम को रिज़ॉल्व नहीं कर पाता है। परिणामस्वरूप, MongoDB ड्राइवर DNS एरर देता है और लगातार MongoServerSelectionError: getaddrinfo ENOTFOUND a1b2c3d4e5f6 लॉग करता रहता है। हमेशा उस स्पष्ट सर्विस नाम के साथ इनिशियलाइज़ करें जो आपके MONGO_URL से मेल खाता हो।
पहला बूट: इसे शुरू होते हुए देखें
एक बार जब सेट primary बन जाता है, तो Rocket.Chat का अगला रीस्टार्ट सफलतापूर्वक कनेक्ट हो जाता है और अपने first-run migrations शुरू कर देता है। लॉग्स को फॉलो करें:
sudo docker compose logs -f rocketchatवह लाइन जिसका आपको इंतज़ार करना है, वह startup banner है:
+--------------------------------------------+
SERVER RUNNING
Rocket.Chat Version: 8.5.1
NodeJS Version: 22.22.3 - x64
+--------------------------------------------+पहला बूट धीमा होता है, क्योंकि ऐप database migrations चलाता है और indexes बनाता है, इसलिए चिंता करने से पहले इसे एक या दो मिनट का समय दें। यदि लॉग बार-बार MongoServerSelectionError: Server selection timed out after 30000 ms को ReplicaSetNoPrimary प्रकार के topology description के साथ दोहराता है, तो ड्राइवर के पास कोई ज्ञात primary नहीं है; initialization की कमी, election, या unreachable primary के लिए rs.status() की जाँच करें। यदि यह किसी रैंडम हैश पर बार-बार getaddrinfo ENOTFOUND दिखाता है, तो replica set कॉन्फ़िगरेशन में advertised member hostname की जाँच करें। एक बार जब आप SERVER RUNNING देख लेते हैं, तो Rocket.Chat 127.0.0.1:3000 पर listening मोड में होता है और अब इसके सामने एक वास्तविक hostname और TLS लगाने का समय आ गया है।
इसे TLS के पीछे रखें
Rocket.Chat को कभी भी plain HTTP पर expose न करें। एक बार http:// पर लॉग इन करने का मतलब है कि आपने अपना एडमिन पासवर्ड रास्ते में मौजूद किसी भी व्यक्ति को सौंप दिया है। उसी बॉक्स पर एक reverse proxy में TLS terminate करें और 127.0.0.1:3000 पर forward करें। दो बातें महत्वपूर्ण हैं: proxy को WebSocket upgrade headers को forward करना चाहिए, क्योंकि Rocket.Chat real-time है और इनके बिना काम नहीं करेगा, और container का ROOT_URL उपयोगकर्ताओं द्वारा टाइप किए गए public HTTPS पते से बिल्कुल मेल खाना चाहिए।
एक plain HTTP nginx सर्वर ब्लॉक के साथ शुरुआत करें जो ऐप को proxy करता है और upgrade headers को forward करता है। इसे /etc/nginx/sites-available/rocketchat के रूप में सहेजें, इसे sites-enabled में symlink करें, और reload करें:
server {
listen 80;
server_name chat.example.com;
client_max_body_size 100M;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}इसे अभी के लिए port 80 पर छोड़ दें, listen 443 ssl; वाला ब्लॉक और बिना certificate के यह sudo nginx -t को भी पास नहीं करेगा। nginx को reload करें (sudo nginx -t && sudo systemctl reload nginx), फिर certificate जारी करें। Ubuntu पर सबसे साफ रास्ता Certbot और nginx के साथ Let's Encrypt TLS certificates है: certbot --nginx ऊपर दिए गए ब्लॉक को वहीं rewrite करता है, जिसमें listen 443 ssl;, ssl_certificate लाइनें, और एक स्वचालित 80-से-443 रीडायरेक्ट जोड़ता है, और यह आपके लिए renewal को शेड्यूल करता है। यदि आप पहले से ही एक proxy के पीछे कई containers चला रहे हैं, तो कई Docker ऐप्स के लिए स्वचालित TLS के साथ Traefik अधिक व्यवस्थित विकल्प है, rocketchat सर्विस में router और service labels जोड़ें और Traefik आपके लिए certificate का अनुरोध और नवीनीकरण करता है, बिना किसी nginx ब्लॉक के। किसी भी तरह, compose.yml में ROOT_URL को https://chat.example.com पर सेट करें और sudo docker compose up -d को फिर से चलाएं ताकि container बदलाव को लागू कर सके। यदि आप चाहते हैं कि सर्वर public internet के बजाय केवल आपके अपने नेटवर्क के अंदर से ही पहुंच योग्य हो, तो इसे VPS पर self-hosted WireGuard VPN के साथ front करें और proxy को tunnel पते पर bind करें।
प्रथम-रन सेटअप विज़ार्ड
https://chat.example.com पर ब्राउज़ करें और Rocket.Chat आपको एक संक्षिप्त विज़ार्ड के माध्यम से ले जाएगा। सबसे पहले, admin account, एक वास्तविक नाम, उपयोगकर्ता नाम, ईमेल और एक मजबूत पासवर्ड दर्ज करें; यह एकमात्र खाता है जो मौजूद है, इसलिए इसे खोएं नहीं। इसके बाद, organisation info, नाम, उद्योग, आकार और देश दर्ज करें। Rocket.Chat का वर्तमान सेटअप दस्तावेज़ीकरण Rocket.Chat Cloud के साथ workspace को रजिस्टर करना अनिवार्य बनाता है; यह ऑनलाइन और ऑफलाइन पंजीकरण का दस्तावेजीकरण करता है, न कि कोई ऐसा स्टैंडअलोन विकल्प जो पंजीकरण को छोड़ दे।
पंजीकरण Rocket.Chat के गेटवे के माध्यम से मोबाइल पुश नोटिफिकेशन और ऐड-ऑन मार्केटप्लेस को सक्षम बनाता है, लेकिन इसके बदले में Rocket.Chat के क्लाउड के साथ एक कंट्रोल-प्लेन संबंध बनता है; गेटवे के माध्यम से भेजे गए पुश आपके वर्कस्पेस की मासिक सीमा में गिने जाते हैं। क्लाउड सेवाओं के लिए Rocket.Chat का ऐसा संस्करण भी आवश्यक है जो इसके सपोर्ट विंडो के भीतर हो। आधिकारिक iOS और Android ऐप्स केवल Rocket.Chat के गेटवे के माध्यम से ही पुश नोटिफिकेशन प्राप्त करते हैं, जिसके लिए एक पंजीकृत वर्कस्पेस और क्लाउड सर्विस प्राइवेसी शर्तों की स्वीकृति आवश्यक है। इसका समाधान मोबाइल ऐप का आपका अपना व्हाइट-लेबल बिल्ड है: Push सेटिंग्स में गेटवे को बंद करें, अपने स्वयं के APNs सर्टिफिकेट और Firebase Cloud Messaging क्रेडेंशियल्स पेस्ट करें, और अपने उपयोगकर्ताओं से आधिकारिक ऐप के बजाय अपना ऐप इंस्टॉल करवाएं। गेटवे सेटिंग्स बदलने के बाद Rocket.Chat को रीस्टार्ट करें।
किसी को भी आमंत्रित करने से पहले इसे सुरक्षित करें
किसी को भी आमंत्रित करने से पहले Registration Form की जाँच करें: जब यह Public पर सेट होता है, तो कोई भी व्यक्ति जिसे URL मिल जाए, वह खाता बना सकता है। सार्वजनिक hostname पर यह एक खुला दरवाजा है। Manage → Workspace → Settings → Accounts → Registration पर जाएँ और Registration Form को Disabled पर सेट करें, ताकि आप स्वयं या invite link के माध्यम से खाते बना सकें, या इसे Secret URL पर सेट करें। वहीं रहते हुए, Allow Anonymous Read और Allow Anonymous Write को बंद कर दें, जब तक कि आप विशेष रूप से सार्वजनिक read-only चैनल न चाहते हों। यदि हर खाता हाथ से बनाना थकाऊ लगता है और यह एकमात्र ऐसी सेवा नहीं है जिसमें आपकी टीम लॉग इन करती है, तो Rocket.Chat के OAuth लॉगिन को एक self-hosted Authentik SSO server की ओर निर्देशित करें, ताकि नए जुड़ने वालों और छोड़ने वालों को हर ऐप के बजाय एक ही स्थान पर प्रबंधित किया जा सके।
यह भी तय करें कि uploads कहाँ जाएँ। डिफ़ॉल्ट File Upload स्टोरेज GridFS है, जो हर image और attachment को सीधे MongoDB के अंदर स्टोर करता है। यह सरल है, लेकिन इसका मतलब है कि आपका डेटाबेस, और आपके द्वारा लिया गया हर mongodump, बिना किसी सीमा के बढ़ता जाता है क्योंकि लोग screenshots पेस्ट करते हैं। Manage → Workspace → Settings → File Upload के अंतर्गत आप स्टोरेज को local filesystem या S3-compatible bucket पर स्विच कर सकते हैं, और एक उचित अधिकतम फ़ाइल आकार सेट कर सकते हैं। यदि आपकी टीम कभी-कभार के screenshot के बजाय पूरी photo libraries साझा कर रही है, तो उन्हें चैट डेटाबेस के बजाय एक समर्पित photo server पर होना चाहिए, और PhotoPrism और Immich की तुलना यह बताती है कि प्रत्येक के लिए RAM और आवश्यक backup commands के संदर्भ में क्या लागत आती है। एक छोटी टीम के लिए GridFS ठीक है; बस यह ध्यान रखें कि समय के साथ आपके backups भारी होते जाएंगे।
mongodump के साथ बैकअप
डिफ़ॉल्ट GridFS स्टोरेज के साथ, आपका वर्कस्पेस डेटा mongodb_data वॉल्यूम में रहता है। चलते हुए डेटाबेस के नीचे से केवल वॉल्यूम को कॉपी न करें, mongodump के साथ एक डंप लें, जिसे होस्ट पर एक फ़ाइल में स्ट्रीम किया गया हो। इस डेटाबेस-ओनली डंप की अवधि के दौरान Rocket.Chat और किसी भी अन्य राइटर को रोक दें ताकि यह सुसंगत रहे, फिर डंप सफल होने के बाद Rocket.Chat को पुनः प्रारंभ करें:
sudo docker compose stop rocketchat
sudo docker compose exec -T mongodb mongodump --db rocketchat --archive --gzip > rocketchat-$(date +%F).archive.gz
sudo docker compose start rocketchatवह एकल gzipped आर्काइव आपका पूरा वर्कस्पेस है: यूज़र, चैनल, मैसेज, सेटिंग्स, और यदि आपने अपलोड को GridFS पर छोड़ दिया है, तो फ़ाइलें भी। यदि आपने अपलोड को फ़ाइल सिस्टम या S3 पर स्थानांतरित कर दिया है, तो उस स्टोर का अलग से बैकअप लें। पहले रेप्लिका सेट को इनिशियलाइज़ करके एक फ्रेश स्टैक पर रिस्टोर करें, फिर रिस्टोर करते समय Rocket.Chat को रोक दें:
sudo docker compose stop rocketchat
sudo docker compose exec -T mongodb mongorestore --archive --gzip --drop < rocketchat-2026-07-15.archive.gz
sudo docker compose start rocketchatआर्काइव को बॉक्स से बाहर, ऑब्जेक्ट स्टोरेज, किसी अन्य सर्वर पर, या ऐसी किसी भी जगह कॉपी करें जहाँ VPS के खराब होने पर बैकअप उसके साथ नष्ट न हो, और हर रात cron से डंप चलाएं। जिस बैकअप को आपने कभी रिस्टोर नहीं किया है, वह केवल एक उम्मीद है, बैकअप नहीं; इसे एक बार किसी अस्थायी VPS पर रिस्टोर करने का अभ्यास करें ताकि आपको पता हो कि ज़रूरत पड़ने से पहले यह काम करता है।
अपग्रेड: टैग पिन करें, नोट्स पढ़ें, और MongoDB मैट्रिक्स का पालन करें
अपग्रेड को सुचारू रखने के लिए दो नियमों का पालन करें। पहला, Rocket.Chat को एक बार में एक ही मेजर वर्जन अपग्रेड करें। यह बूट होने पर स्कीमा माइग्रेशन चलाता है, और Rocket.Chat के अपग्रेड डॉक्यूमेंटेशन के अनुसार हमेशा मेजर वर्जन के क्रम में ही अपडेट करना चाहिए। मेजर वर्जन छोड़ने से गंभीर कम्पैटिबिलिटी समस्याएं हो सकती हैं। सॉफ्टवेयर पर भरोसा न करें कि वह आपको ऐसा करने से रोकेगा: इसके डॉक्यूमेंटेशन में कहीं भी यह वादा नहीं है कि 6.x से सीधे 8.x पर जाना सुरक्षित रूप से अस्वीकार कर दिया जाएगा। यदि माइग्रेशन बीच में विफल हो जाता है, तो यह लॉक सेट छोड़ देता है जिसे मैन्युअल रूप से ठीक करना पड़ता है। इमेज टैग को अगले मेजर वर्जन के नवीनतम रिलीज पर बढ़ाएं, उस रिलीज के ब्रेकिंग बदलावों के लिए नोट्स पढ़ें, docker compose up -d चलाएं, और आगे बढ़ने से पहले लॉग्स में माइग्रेशन पूरा होने तक प्रतीक्षा करें। दूसरा, MongoDB सपोर्ट मैट्रिक्स का सम्मान करें। टारगेट रिलीज की इंजन आवश्यकताओं और Rocket.Chat के सपोर्ट टेबल की एक साथ जांच करें: सूचीबद्ध MongoDB वर्जन एक न्यूनतम आवश्यकता है, और Rocket.Chat 8.x, MongoDB 8.0 और उससे ऊपर के वर्जन को सपोर्ट करता है, जिसे 8.2 के साथ सत्यापित किया गया है। जब आप MongoDB को अपग्रेड करें, उदाहरण के लिए 7.0 से 8.0 पर, तो एक बार में एक मेजर वर्जन ही आगे बढ़ें और प्रत्येक चरण के बाद फीचर-कम्पैटिबिलिटी वर्जन सेट करें। MongoDB 8.0 पर इस कमांड के लिए एक स्पष्ट confirm: true की आवश्यकता होती है, अन्यथा यह एक संदेश के साथ इसे अस्वीकार कर देगा जिसमें आपको कन्फर्मेशन फ्लैग के साथ इसे फिर से चलाने के लिए कहा जाएगा:
sudo docker compose exec mongodb mongosh --eval 'db.adminCommand({setFeatureCompatibilityVersion: "8.0", confirm: true})'किसी भी घटक के अपग्रेड से पहले mongodump लें। अपने Compose कॉन्फ़िगरेशन और किसी भी बाहरी अपलोड स्टोर को भी सेव करें, ताकि बैकअप में पूरा डिप्लॉयमेंट शामिल हो।
विफलता के प्रकार, सटीक strings के साथ
Rocket.Chat, docker compose up के तुरंत बाद restart-loop में चला जाता है और docker compose logs rocketchat में MongoServerSelectionError भर जाता है। ड्राइवर एक उपयुक्त MongoDB सर्वर का चयन नहीं कर पा रहा है; कारण जानने के लिए topology description और अंतर्निहित त्रुटियों की जाँच करें। ReplicaSetNoPrimary के topology type के साथ Server selection timed out after 30000 ms का अर्थ है कि ड्राइवर जानता है कि वह एक replica set से जुड़ रहा है, लेकिन उसे कोई primary नहीं मिल रहा है; इसके संभावित कारणों में initialization का न होना, election की प्रक्रिया, या primary का unreachable होना शामिल है। getaddrinfo ENOTFOUND के बाद एक random hash आने का मतलब है कि advertised member का hostname resolve नहीं हो पा रहा है। sudo docker compose exec mongodb mongosh --eval 'rs.status()' के साथ निदान करें: यदि यह MongoServerError: no replset config has been received त्रुटि देता है, तो set को initiate करें; यदि यह ऐसे member को दिखाता है जिसका name एक random hash है, तो rs.conf() के साथ configuration प्राप्त करें, उस member के host को mongodb:27017 में बदलें, और primary पर rs.reconfig() के साथ इसे apply करें। यदि configuration सही है, तो member की स्थिति, MongoDB logs और Rocket.Chat container से connectivity की जाँच करें।
Web UI लोड होता है लेकिन login प्रक्रिया घूमती रहती है और कभी पूरी नहीं होती। ब्राउज़र console खोलें, आपको WebSocket connection to 'wss://chat.example.com/websocket' failed दिखाई देगा। यह लगभग हमेशा ROOT_URL का मेल न खाना या किसी ऐसे proxy के कारण होता है जो upgrade headers को forward नहीं कर रहा है। पुष्टि करें कि ROOT_URL, https:// सहित सटीक public address के बराबर है, और आपका nginx location block, proxy_http_version 1.1 के साथ Upgrade और Connection "upgrade" को सेट करता है। ROOT_URL बदलने के बाद, docker compose up -d को फिर से चलाएँ; nginx बदलने के बाद, sudo nginx -t && sudo systemctl reload nginx चलाएँ।
एक container बार-बार बंद हो रहा है और docker compose ps दिखाता है कि यह Restarting है। docker compose logs बीच में ही कट जाता है और sudo dmesg | tail में oom-killer से Out of memory: Killed process 12345 (mongod) दिखाई देता है; exit code 137 है। सर्वर की RAM समाप्त हो गई है। इसका वास्तविक समाधान एक बड़ा VPS है, कम से कम 4 GB। अस्थायी उपाय के रूप में swap जोड़ें और MongoDB के cache को उसके command में --wiredTigerCacheSizeGB के साथ सीमित करें। इसे default से ऊपर के बजाय नीचे सेट करें, उदाहरण के लिए 4 GB वाले बॉक्स पर 1 (default 1.5) या 2 GB वाले बॉक्स पर 0.3 (default लगभग 0.5), लेकिन swap वास्तविक load के तहत अगले OOM को केवल कुछ समय के लिए टालता है:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfiledocker compose up, Error response from daemon: driver failed programming external connectivity ... bind: address already in use के साथ विफल हो जाता है। पोर्ट 3000 पर पहले से ही कोई प्रक्रिया चल रही है, अक्सर यह कोई पिछला Rocket.Chat container होता है जो ठीक से बंद नहीं हुआ, या कोई अन्य app। इसे sudo ss -ltnp | grep :3000 के साथ ढूँढें, उस प्रक्रिया या container को रोकें, या mapping के host side को 127.0.0.1:3001:3000 में बदलें और अपने proxy के proxy_pass को तदनुसार अपडेट करें।
FAQ
क्या Rocket.Chat को वास्तव में MongoDB replica set की आवश्यकता है?
हाँ, एक सिंगल सर्वर और एक डेटाबेस नोड के लिए भी यह जरूरी है। Rocket.Chat वास्तविक समय में संदेश भेजने के लिए MongoDB change streams का उपयोग करता है, जिसके लिए replica set या sharded cluster की आवश्यकता होती है; एक standalone mongod इसे ओपन नहीं कर सकता। आपको कई मशीनों की आवश्यकता नहीं है; आप --replSet rs0 के साथ एक MongoDB container चलाएं और rs.initiate() के साथ एक-सदस्यीय सेट को इनिशियलाइज़ करें। यदि आप उस चरण को छोड़ देते हैं, तो ड्राइवर को कभी भी primary नहीं मिलेगा, जिससे Rocket.Chat MongoServerSelectionError: Server selection timed out के साथ restart-loop में फंस जाएगा और कभी बूट नहीं होगा।
self-hosted Rocket.Chat को कितनी RAM की आवश्यकता होती है?
व्यावहारिक न्यूनतम के रूप में 4 GB और एक व्यस्त टीम के लिए 8 GB की योजना बनाएं। Rocket.Chat का Node प्रोसेस लगभग 1 से 1.5 GB RAM का उपयोग करता है, और MongoDB का डिफ़ॉल्ट WiredTiger कैश (कुल RAM माइनस 1 GB) का आधा होता है, जिसे इस तरह आकार दिया जाता है जैसे कि बॉक्स पर कुछ और नहीं चल रहा हो। 2 GB वाले बॉक्स पर वह कैश, Node का हीप और mongod का अपना ओवरहेड आपस में टकराते हैं, और out-of-memory killer किसी भी वास्तविक लोड के तहत mongod को समाप्त कर देता है, जिससे लॉग में Killed और exit code 137 दिखाई देता है। 2 GB केवल कुछ टेस्ट उपयोगकर्ताओं के साथ सॉफ़्टवेयर का मूल्यांकन करने के लिए पर्याप्त है।
मैं Rocket.Chat को HTTPS के पीछे कैसे रखूँ?
उसी VPS पर एक reverse proxy चलाएं जो TLS को समाप्त करे और 127.0.0.1:3000 पर फॉरवर्ड करे, और कंटेनर के ROOT_URL को अपने सार्वजनिक https:// पते पर सेट करें। प्रॉक्सी को WebSocket अपग्रेड हेडर को फॉरवर्ड करना होगा, अन्यथा लॉगिन अटक जाएगा। nginx के साथ Certbot सबसे सरल सिंगल-ऐप सेटअप है; यदि आप एक प्रॉक्सी के पीछे कई कंटेनर चलाते हैं और स्वचालित सर्टिफिकेट प्रबंधन चाहते हैं, तो Traefik बेहतर है।
मैं self-hosted Rocket.Chat का बैकअप कैसे लूँ?
इस डेटाबेस-ओनली डंप को लेने से पहले Rocket.Chat और किसी भी अन्य डेटाबेस राइटर को रोक दें: docker compose exec -T mongodb mongodump --db rocketchat --archive --gzip > backup.archive.gz। डंप सफल होने के बाद Rocket.Chat को फिर से शुरू करें। उस आर्काइव में उपयोगकर्ता, चैनल, संदेश और सेटिंग्स शामिल होती हैं, साथ ही यदि आपने स्टोरेज को GridFS पर छोड़ा है तो अपलोड की गई फाइलें भी शामिल होती हैं। इसे सर्वर से बाहर कॉपी करें, cron के साथ इसे रात में स्वचालित करें, और एक थ्रोअवे बॉक्स पर mongorestore का अभ्यास करें ताकि आप जान सकें कि रिस्टोर वास्तव में काम करता है।
मैं MongoDB को तोड़े बिना Rocket.Chat को अपग्रेड कैसे करूँ?
Rocket.Chat को एक बार में एक प्रमुख संस्करण (major version) अपग्रेड करें। यह बूट होने पर माइग्रेशन चलाता है और इसके दस्तावेज़ चेतावनी देते हैं कि प्रमुख संस्करणों को छोड़ने से गंभीर संगतता समस्याएं हो सकती हैं। पिन किए गए इमेज टैग को बदलने से पहले प्रत्येक रिलीज़ के नोट्स पढ़ें। Rocket.Chat के MongoDB सपोर्ट टेबल के विरुद्ध लक्षित रिलीज़ की इंजन आवश्यकताओं की जाँच करें; Rocket.Chat 8.x, MongoDB 8.0 और उससे ऊपर का समर्थन करता है, जिसे 8.2 के साथ सत्यापित किया गया है। जब आप MongoDB को मूव करते हैं, तो एक बार में एक प्रमुख संस्करण आगे बढ़ें और प्रत्येक हॉप के बाद setFeatureCompatibilityVersion सेट करें; MongoDB 7.0 और बाद के संस्करणों के लिए confirm: true की आवश्यकता होती है। हमेशा पहले mongodump लें।