Docker Compose کے ذریعے Rocket.Chat کو خود ہوسٹ کریں
Docker Compose کا استعمال کرتے ہوئے اپنے VPS پر Rocket.Chat انسٹال کریں۔ MongoDB replica set کی ترتیب، TLS کنفیگریشن اور ڈیٹا بیک اپ کے تمام مراحل اس گائیڈ میں موجود ہیں۔
آپ کیا بنا رہے ہیں
ایک نجی team chat جس پر آپ کا مکمل اختیار ہو: Rocket.Chat آپ کے اپنے VPS پر Docker Compose کے تحت چل رہا ہو، TLS کے ذریعے محفوظ کیا گیا ہو، اور ہر message MongoDB database میں موجود ہو جس کا backup لے کر اسے منتقل کیا جا سکے۔ Rocket.Chat ایک پختہ open-source Slack اور Teams متبادل ہے۔ اس میں channels، direct messages، threads، file sharing، voice اور video شامل ہیں، اور یہ سب ایسے hardware پر چلتا ہے جسے آپ کرائے پر لے کر خود control کرتے ہیں۔ تاہم یہ واحد قابلِ اعتماد option نہیں ہے۔ اگر آپ ابھی انتخاب کر رہے ہیں تو Mattermost، Rocket.Chat، Synapse اور Zulip کا تقابل ان پہلوؤں کے لحاظ سے ان کا موازنہ کرتا ہے جو بعد میں مسائل پیدا کرتے ہیں: RAM، database، mobile push، SSO اور upgrades۔ application ایک single container ہے جو چند منٹ میں start ہو جاتا ہے۔ حقیقت میں جو کچھ خراب ہوتا ہے وہ اسی کے ساتھ موجود database میں ہوتا ہے۔ اسی لیے اس guide کا زیادہ تر حصہ MongoDB کے بارے میں ہے، اور خاص طور پر اس ایک requirement کے بارے میں جو پہلی بار سب کو حیران کرتی ہے: Rocket.Chat standalone MongoDB کے ساتھ نہیں چلتا۔ اسے replica set درکار ہوتا ہے، چاہے وہ "set" صرف ایک node ہی پر مشتمل ہو۔
شرائطِ پیشگی، اور RAM کا وہ حساب جو کوئی نہیں بتاتا
مشین کی گنجائش کا حقیقت پسندانہ اندازہ لگائیں۔ ایک چھوٹی ٹیم کے لیے عملی کم از کم گنجائش 2 vCPU اور 4 GB RAM ہے۔ Rocket.Chat کا Node.js process اکیلے تقریباً 1 سے 1.5 GB memory چاہتا ہے، جبکہ MongoDB کا WiredTiger cache بطورِ پیش فرض، (کل RAM میں سے 1 GB نکالنے کے بعد) اس کے 50% یا 0.256 GB، جو بھی زیادہ ہو، کے برابر ہوتا ہے۔ یہ default اس مفروضے پر مبنی ہے کہ mongod کے پاس پوری مشین موجود ہے: اس کا حساب کل RAM سے کیا جاتا ہے اور Node پہلے سے کتنی memory استعمال کر رہا ہے، اسے شمار نہیں کیا جاتا۔ اسی لیے 4 GB کی مشین پر یہ 1.5 GB اور 2 GB کی مشین پر تقریباً 0.5 GB بنتا ہے۔ یہ مقدار Node کے heap، mongod کی cache سے باہر اپنی memory، اور operating system کی ضرورت کے علاوہ ہے۔ 2 GB VPS پر boot کے وقت دونوں services چل جاتی ہیں، لیکن حقیقی traffic آتے ہی ان میں memory کا تصادم شروع ہو جاتا ہے: MongoDB اپنی cache بڑھاتا ہے، Node اپنا heap بڑھاتا ہے، kernel کے پاس pages ختم ہو جاتے ہیں، اور out-of-memory killer سب سے بڑے process کو ختم کر دیتا ہے، جو عموماً mongod ہوتا ہے۔ container Killed دکھاتا ہے، Docker اسے دوبارہ شروع کرتا ہے، اور آپ کو ایسا chat server ملتا ہے جو اس load میں ہر چند منٹ بعد disconnect ہو جاتا ہے جسے اسے آسانی سے سنبھالنا چاہیے۔ دو افراد کے ساتھ ابتدائی آزمائش کے لیے 2 GB کافی ہے؛ team server کے لیے نہیں۔ 4 GB سے شروع کریں، اور اگر آپ کو درجنوں concurrent users، video calls، یا بڑھتا ہوا upload history متوقع ہو تو 8 GB دیں۔ مشین پر چلنے والی دوسری چیزوں کے لیے بھی گنجائش رکھیں: اسی VPS پر Notion طرز کا AFFiNE workspace رکھنے سے مزید چار containers انہی memory pages کے لیے مقابلہ کریں گے، اس لیے ان کی RAM Rocket.Chat کی RAM میں سے نہیں بلکہ اس کے علاوہ درکار ہوگی۔
شروع کرنے سے پہلے تین چیزیں موجود ہونی چاہییں۔ پہلے، ایسا domain name جس کا A record VPS کے public IP کی طرف اشارہ کرتا ہو؛ Rocket.Chat کے real-time features اور mobile clients کو bare IP کے بجائے ایک مستحکم hostname درکار ہوتا ہے۔ دوسرے، server firewall اور آپ کے provider کے network firewall، دونوں پر Ports 80 and 443 open ہوں۔ زیادہ تر control panels میں یہ الگ configuration ہوتی ہے۔ تیسرے، root یا sudo کے ساتھ ایک تازہ Ubuntu 24.04 KVM VPS ہو۔ اگر آپ ابھی فیصلہ کر رہے ہیں کہ chat server آپ کی پہلی service کے لیے موزوں ہے یا نہیں، تو 2026 میں self-hosting کے قابل چیزوں کی guide ان tradeoffs کی وضاحت کرتی ہے۔
Docker engine اور Compose plugin کو انسٹال کریں
Ubuntu کے ساتھ آنے والے docker.io پیکیج اور پرانے standalone docker-compose Python binary کے بجائے Docker کا اپنا apt repository استعمال کریں۔ جدید Compose ایک Docker plugin ہے جسے آپ docker compose کے طور پر چلاتے ہیں، یعنی ایک 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 پرنٹ کرتے ہیں (v5.6.0، جو 2 اکتوبر 2026 کو ریلیز ہوا، 2026-10-10 تک تازہ ترین تھا)؛ پرانی تنصیب اب بھی v2.x پرنٹ کر سکتی ہے، اور Docker دونوں کو سپورٹ کرتا ہے۔ Docker کے مطابق Compose v5 فعالیت کے لحاظ سے v2 جیسا ہی ہے، اسے v5 کا نمبر اس لیے دیا گیا ہے تاکہ پرانے v2 اور v3 compose file formats کے ساتھ الجھن نہ ہو۔ لہذا اس گائیڈ کے لیے دونوں میں سے کوئی بھی ٹھیک ہے۔ اگر یہ docker: 'compose' is not a docker command کے ساتھ error دیتا ہے، تو اس کا مطلب ہے کہ plugin انسٹال نہیں ہوا اور آپ کو بعد میں الجھا دینے والی ناکامیوں کا سامنا کرنا پڑے گا، اس لیے اسے یہیں ٹھیک کریں۔
Compose فائل: MongoDB بطور سنگل نوڈ ریپلیکا سیٹ
یہ وہ حصہ ہے جہاں لوگ غلطی کرتے ہیں، لہذا اسے غور سے پڑھیں۔ Rocket.Chat نئے پیغامات کو ریئل ٹائم میں منسلک کلائنٹس تک پہنچانے کے لیے MongoDB change streams کا استعمال کرتا ہے، اور change streams صرف ریپلیکا سیٹس اور شارڈڈ کلسٹرز پر دستیاب ہوتے ہیں، نہ کہ اسٹینڈ الون سرورز پر۔ اگر آپ Rocket.Chat کو ایک عام اسٹینڈ الون mongod پر پوائنٹ کریں گے تو یہ منسلک تو ہو جائے گا، لیکن change stream کھولنے میں ناکام رہے گا اور ہمیشہ کے لیے restart-loop میں پھنس جائے گا۔ اس کا حل پیچیدہ نہیں ہے: آپ ایک عام MongoDB کنٹینر چلائیں، لیکن اسے --replSet کے ساتھ شروع کریں اور پھر ایک ممبر پر مشتمل سیٹ کو انیشیالائز کریں۔
ایک ورکنگ ڈائریکٹری اور ایک 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 پورٹ کو 127.0.0.1:3000 پر پبلش کیا گیا ہے، نہ کہ 0.0.0.0 پر، کیونکہ ایپ میں خود کوئی TLS نہیں ہے، اس لیے صرف اسی مشین پر موجود ریورس پراکسی کو اس تک رسائی حاصل ہونی چاہیے؛ اسے ہر انٹرفیس پر بائنڈ کرنے کا مطلب پبلک انٹرنیٹ پر براہ راست پلین ٹیکسٹ لاگ ان پیج کو ظاہر کرنا ہوگا۔ MongoDB کو ہوسٹ پر بالکل بھی پبلش نہیں کیا گیا ہے؛ یہ صرف Compose کے انٹرنل نیٹ ورک پر mongodb نام کے تحت قابل رسائی ہے، جو کہ بالکل وہی ہوسٹ نیم ہے جسے MONGO_URL استعمال کرتا ہے۔ MONGO_URL میں ?replicaSet=rs0 شامل ہے، جو سیٹ کا واضح نام متعین کرتا ہے؛ MongoDB ڈرائیورز کے درمیان مستقل رویے کے لیے اسے سیٹ کرنے کی سفارش کرتا ہے۔ اسے چھوڑ دینے سے خود بخود کچھ خراب نہیں ہوتا: directConnection ڈیفالٹ طور پر false ہوتا ہے، لہذا ڈرائیور پھر بھی ریپلیکا سیٹ کو دریافت کر لیتا ہے اور پرائمری کو آپریشنز بھیجتا ہے، بشرطیکہ سیٹ کو ایسے ہوسٹ نیم کے ساتھ شروع کیا گیا ہو جسے Rocket.Chat ریزولو کر سکے، جس کا انتظام اگلا سیکشن کرتا ہے۔ MONGO_OPLOG_URL کو Rocket.Chat 8.0.0 میں ہٹا دیا گیا تھا، اس لیے اسے یہاں شامل نہیں کیا گیا؛ Rocket.Chat اب اس کی جگہ MongoDB change streams استعمال کرتا ہے۔ depends_on میں condition: service_healthy کا استعمال کیا گیا ہے، لہذا Compose تب تک Rocket.Chat شروع نہیں کرتا جب تک MongoDB ping کا جواب نہ دے دے، ہیلتھ چیک کا مقصد یہی ہے۔
دونوں امیجز پر حقیقی ورژن ٹیگز پن کریں، جیسے mongo:8.0 اور Rocket.Chat کا واضح ریلیز جیسے کہ یہاں 8.5.1، اور :latest سے گریز کریں، جو اگلی بار کنٹینر دوبارہ بناتے وقت غیر متوقع ورژن کا انتخاب کر سکتا ہے۔ docker pull صرف امیج ڈاؤن لوڈ کرتا ہے؛ اسے ڈیپلائے کرنے کے لیے ایک اور ایکشن کی ضرورت ہوتی ہے، جیسے docker compose up -d، اور جب نیا کنٹینر شروع ہوتا ہے تو Rocket.Chat اپنی مائیگریشنز خود چلاتا ہے۔ پن کرنے سے پہلے موجودہ مستحکم Rocket.Chat ریلیز اور اس کے معاون MongoDB ورژنز کو چیک کریں۔ Rocket.Chat کا سپورٹ ٹیبل Rocket.Chat 8.x کے لیے MongoDB 8.0 اور اس سے اوپر کے ورژنز کی فہرست دیتا ہے، جس کی تصدیق 8.2 کے ساتھ کی گئی ہے، لہذا mongo:8.0 واحد معاون انجن کے بجائے ایک معاون انتخاب ہے۔ 8.5.1 ریلیز نوٹس اسے ایک LTS بلڈ کے طور پر شناخت کرتے ہیں۔ ہر پروجیکٹ ورژن والی امیج شائع نہیں کرتا، ایسی صورت میں پن کا عمل سورس پر منتقل ہو جاتا ہے: self-hosting the openGym workout tracker کا مطلب ہے کہ کسی مخصوص git ٹیگ کو چیک آؤٹ کرنا اور اسے بلڈ کرنا، بجائے اس کے کہ کسی متحرک برانچ کی پیروی کی جائے۔
ریپلیکا سیٹ شروع کریں
Stack کو شروع کریں:
sudo docker compose up -dRocket.Chat فوراً crash ہونا شروع ہو جائے گا اور Docker اسے مسلسل restart کرتا رہے گا۔ یہ متوقع ہے، کیونکہ ابھی replica set موجود نہیں ہے۔ اسے ایک بار دستی طور پر بنائیں:
sudo docker compose exec mongodb mongosh --eval 'rs.initiate({_id: "rs0", members: [{_id: 0, host: "mongodb:27017"}]})'درست نتیجہ { ok: 1 } ہے۔ چند سیکنڈ میں single node خود کو primary منتخب کر لیتا ہے؛ اس کی تصدیق کریں:
sudo docker compose exec mongodb mongosh --quiet --eval 'rs.status().members[0].stateStr'آپ کو PRIMARY نظر آنا چاہیے۔ اس پورے صفحے کی سب سے اہم تفصیل host: "mongodb:27017" argument ہے۔ اگر آپ members list کے بغیر سادہ rs.initiate() چلاتے ہیں تو MongoDB replica set کو container کے internal hostname کے تحت advertise کرتا ہے، مثلاً a1b2c3d4e5f6 جیسا random hash۔ اپنے container سے connect کرتے وقت Rocket.Chat اس نام کو resolve نہیں کر سکتا، اس لیے MongoDB driver اس پر DNS failure کے بعد مسلسل loop میں رہتا ہے اور MongoServerSelectionError: getaddrinfo ENOTFOUND a1b2c3d4e5f6 log کرتا رہتا ہے۔ ہمیشہ اپنے MONGO_URL سے مطابقت رکھنے والے explicit service name کے ساتھ initiate کریں۔
پہلا بوٹ: سروس کے شروع ہونے کا مشاہدہ
ایک بار جب سیٹ پرائمری بن جائے، تو Rocket.Chat کا اگلا ری اسٹارٹ کامیابی سے جڑ جاتا ہے اور اپنی پہلی رن کی مائیگریشنز شروع کر دیتا ہے۔ لاگز کو فالو کریں:
sudo docker compose logs -f rocketchatجس لائن کا آپ کو انتظار ہے وہ اسٹارٹ اپ بینر ہے:
+--------------------------------------------+
SERVER RUNNING
Rocket.Chat Version: 8.5.1
NodeJS Version: 22.22.3 - x64
+--------------------------------------------+پہلا بوٹ سست ہوتا ہے، ایپ ڈیٹا بیس مائیگریشنز چلاتی ہے اور انڈیکس بناتی ہے، لہذا پریشان ہونے سے پہلے اسے ایک یا دو منٹ کا وقت دیں۔ اگر لاگ اس کے بجائے MongoServerSelectionError: Server selection timed out after 30000 ms کو ReplicaSetNoPrimary قسم کی ٹوپولوجی تفصیل کے ساتھ دہراتا ہے، تو ڈرائیور کے پاس کوئی معلوم پرائمری نہیں ہے؛ نامکمل انیشلائزیشن، الیکشن، یا ناقابل رسائی پرائمری کے لیے rs.status() کو چیک کریں۔ اگر یہ کسی بے ترتیب ہیش پر getaddrinfo ENOTFOUND کو دہراتا ہے، تو ریپلیکا سیٹ کنفیگریشن میں ایڈورٹائزڈ ممبر ہوسٹ نیم کو چیک کریں۔ ایک بار جب آپ SERVER RUNNING دیکھ لیں، تو Rocket.Chat 127.0.0.1:3000 پر لسن کر رہا ہے اور اب وقت ہے کہ اس کے سامنے ایک حقیقی ہوسٹ نیم اور TLS لگایا جائے۔
اسے TLS کے پیچھے رکھیں
Rocket.Chat کو کبھی بھی plain HTTP پر براہ راست دستیاب نہ کریں۔ http:// کے ذریعے لاگ ان کرنے پر آپ اپنا admin password راستے میں موجود ہر شخص کے حوالے کر دیتے ہیں۔ اسی سرور پر موجود reverse proxy میں TLS terminate کریں اور درخواستیں 127.0.0.1:3000 کو forward کریں۔ دو باتیں اہم ہیں: proxy کو WebSocket upgrade headers forward کرنے چاہییں، کیونکہ Rocket.Chat real-time ہے اور ان کے بغیر کام کرنا بند کر دیتا ہے؛ اور container کا ROOT_URL عین اسی public HTTPS address سے match ہونا چاہیے جو صارفین درج کرتے ہیں۔
ایک سادہ HTTP nginx server block سے آغاز کریں جو app کو 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 کے بغیر block sudo nginx -t بھی پاس نہیں کرے گا۔ nginx کو reload کریں (sudo nginx -t && sudo systemctl reload nginx)، پھر certificate جاری کریں۔ Ubuntu پر صاف ترین طریقہ Certbot اور nginx کے ساتھ Let's Encrypt TLS certificates ہے: certbot --nginx اوپر والے block کو وہیں rewrite کرتا ہے، listen 443 ssl;، ssl_certificate lines اور خودکار 80-to-443 redirect شامل کرتا ہے، اور آپ کے لیے renewal schedule کر دیتا ہے۔ اگر آپ پہلے ہی ایک proxy کے پیچھے متعدد containers چلا رہے ہیں تو متعدد Docker apps کے لیے automatic TLS کے ساتھ Traefik زیادہ منظم انتخاب ہے۔ rocketchat service میں router اور service labels شامل کریں، پھر Traefik آپ کے لیے certificate کی درخواست اور renewal کر دے گا، اور nginx block کی ضرورت نہیں رہے گی۔ دونوں صورتوں میں compose.yml میں ROOT_URL کو https://chat.example.com پر set کریں اور sudo docker compose up -d دوبارہ چلائیں تاکہ container یہ تبدیلی حاصل کر لے۔ اگر آپ چاہتے ہیں کہ server public internet کے بجائے صرف آپ کے اپنے network کے اندر سے قابل رسائی ہو تو اسے VPS پر self-hosted WireGuard VPN کے ذریعے سامنے رکھیں اور proxy کو tunnel address پر bind کریں۔
پہلی بار سیٹ اپ وزرڈ
https://chat.example.com پر جائیں اور Rocket.Chat آپ کو ایک مختصر وزرڈ کے ذریعے رہنمائی فراہم کرے گا۔ سب سے پہلے، admin account، ایک اصلی نام، صارف نام، ای میل، اور ایک مضبوط پاس ورڈ درج کریں؛ یہ واحد اکاؤنٹ ہے جو موجود ہوتا ہے، لہذا اسے ضائع نہ کریں۔ اس کے بعد، organisation info، نام، انڈسٹری، سائز اور ملک درج کریں۔ Rocket.Chat کی موجودہ سیٹ اپ دستاویزات کے مطابق ورک اسپیس کو Rocket.Chat Cloud کے ساتھ register کرنا ضروری ہے؛ یہ آن لائن اور آف لائن رجسٹریشن کی وضاحت کرتی ہے، نہ کہ کوئی ایسا اسٹینڈ الون آپشن جو رجسٹریشن کو چھوڑ دے۔
رجسٹریشن Rocket.Chat کے گیٹ وے کے ذریعے موبائل پش نوٹیفکیشنز اور ایڈ آن مارکیٹ پلیس کو فعال کرتی ہے، جس کی قیمت Rocket.Chat کلاؤڈ کے ساتھ کنٹرول پلین کا تعلق ہے۔ گیٹ وے کے ذریعے بھیجی گئی پش نوٹیفکیشنز آپ کے ورک اسپیس کی ماہانہ حد میں شمار ہوتی ہیں۔ کلاؤڈ سروسز کے لیے Rocket.Chat کا ایسا ورژن درکار ہوتا ہے جو اس کے سپورٹ ونڈو کے اندر ہو۔ آفیشل iOS اور Android ایپس صرف Rocket.Chat کے گیٹ وے کے ذریعے پش نوٹیفکیشنز وصول کرتی ہیں، جس کے لیے رجسٹرڈ ورک اسپیس اور کلاؤڈ سروس پرائیویسی شرائط کو قبول کرنا ضروری ہے۔ اس کا متبادل طریقہ موبائل ایپ کا اپنا وائٹ لیبلڈ (white-labeled) ورژن بنانا ہے: Push سیٹنگز میں گیٹ وے کو آف کریں، اپنے APNs سرٹیفکیٹس اور Firebase Cloud Messaging کی اسناد (credentials) درج کریں، اور اپنے صارفین سے آفیشل ایپ کے بجائے اپنی ایپ انسٹال کروائیں۔ گیٹ وے سیٹنگز تبدیل کرنے کے بعد Rocket.Chat کو دوبارہ شروع (restart) کریں۔
کسی کو مدعو کرنے سے پہلے اسے محفوظ بنائیں
کسی کو مدعو کرنے سے پہلے Registration Form کو چیک کریں: جب یہ Public پر سیٹ ہوتا ہے، تو کوئی بھی شخص جو URL تلاش کر لے وہ اکاؤنٹ بنا سکتا ہے۔ ایک public hostname پر یہ ایک کھلا دروازہ ہے۔ Manage → Workspace → Settings → Accounts → Registration پر جائیں اور Registration Form کو Disabled پر سیٹ کریں، تاکہ آپ خود اکاؤنٹ بنائیں یا invite link کے ذریعے، یا اسے Secret URL پر رکھیں۔ وہاں موجود رہتے ہوئے، Allow Anonymous Read اور Allow Anonymous Write کو بند کر دیں، جب تک کہ آپ خاص طور پر کوئی public read-only چینل نہ چاہتے ہوں۔ اگر ہر اکاؤنٹ کو ہاتھ سے بنانا مشکل لگتا ہے اور یہ واحد سروس نہیں ہے جس میں آپ کی ٹیم لاگ ان ہوتی ہے، تو Rocket.Chat کے OAuth لاگ ان کو ایک self-hosted Authentik SSO سرور کی طرف موڑ دیں، تاکہ نئے آنے والوں اور جانے والوں کا انتظام ایک ہی جگہ پر ہو، نہ کہ ہر ایپ کے لیے الگ الگ۔
یہ بھی طے کریں کہ uploads کہاں جائیں گی۔ ڈیفالٹ File Upload اسٹوریج GridFS ہے، جو ہر تصویر اور اٹیچمنٹ کو خود MongoDB کے اندر اسٹور کرتا ہے۔ یہ سادہ ہے، لیکن اس کا مطلب یہ ہے کہ آپ کا ڈیٹا بیس، اور ہر mongodump جو آپ لیتے ہیں، لامحدود بڑھتا جاتا ہے کیونکہ لوگ اسکرین شاٹس پیسٹ کرتے ہیں۔ Manage → Workspace → Settings → File Upload کے تحت آپ اسٹوریج کو local filesystem یا S3-compatible bucket پر منتقل کر سکتے ہیں، اور فائل کا ایک مناسب زیادہ سے زیادہ سائز سیٹ کر سکتے ہیں۔ اگر آپ کی ٹیم کبھی کبھار اسکرین شاٹ کے بجائے پوری فوٹو لائبریریاں شیئر کر رہی ہے، تو انہیں چیٹ ڈیٹا بیس کے بجائے ایک مخصوص فوٹو سرور پر ہونا چاہیے، اور PhotoPrism اور Immich کا موازنہ اس بات کا جائزہ لیتا ہے کہ ہر ایک کو کتنی RAM درکار ہے اور اسے کن بیک اپ کمانڈز کی ضرورت ہے۔ ایک چھوٹی ٹیم کے لیے GridFS ٹھیک ہے؛ بس یہ جان لیں کہ وقت کے ساتھ ساتھ آپ کے بیک اپس کا سائز بڑھتا جائے گا۔
mongodump کے ساتھ بیک اپ
ڈیفالٹ GridFS اسٹوریج کے ساتھ، آپ کے ورک اسپیس کا ڈیٹا mongodb_data والیوم میں موجود ہوتا ہے۔ چلتی ہوئی ڈیٹا بیس کے نیچے سے صرف والیوم کو کاپی نہ کریں، بلکہ mongodump کے ساتھ ایک ڈمپ لیں، جسے ہوسٹ پر موجود فائل میں اسٹریم کیا جائے۔ اس ڈیٹا بیس-اونلی ڈمپ کے دوران Rocket.Chat اور کسی بھی دوسرے رائٹر کو روک دیں تاکہ ڈیٹا مستقل (consistent) رہے، پھر ڈمپ کامیاب ہونے کے بعد 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 پر منتقل کیا ہے، تو اس اسٹور کا الگ سے بیک اپ لیں۔ بحالی (restore) کے لیے پہلے ریپلیکا سیٹ کو انیشلائز کریں، پھر بحالی کے دوران 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 پر بحال کرنے کی مشق کریں تاکہ آپ کو یقین ہو کہ ضرورت پڑنے پر یہ کام کرے گا۔
اپ گریڈز: ٹیگز کو پن کریں، نوٹس پڑھیں، اور Mongo میٹرکس کا احترام کریں
اپ گریڈز کو محفوظ اور سادہ رکھنے کے لیے دو اصول ہیں۔ پہلا، Rocket.Chat کو ایک وقت میں ایک میجر ورژن اپ گریڈ کریں۔ یہ بوٹ کے وقت schema migrations چلاتا ہے، اور Rocket.Chat کی اپ گریڈ دستاویزات کے مطابق ہمیشہ میجر ورژنز کے درمیان ترتیب وار اپ ڈیٹ کرنا چاہیے، کیونکہ میجر ورژنز کو چھوڑنے سے مطابقت (compatibility) کے سنگین مسائل پیدا ہو سکتے ہیں۔ سافٹ ویئر پر انحصار نہ کریں کہ وہ آپ کو روک دے گا: اس کی دستاویزات میں کہیں یہ وعدہ نہیں ہے کہ 6.x سے براہ راست 8.x پر چھلانگ لگانا محفوظ طریقے سے مسترد کر دیا جائے گا، اور اگر migration درمیان میں ناکام ہو جائے تو یہ lock کو سیٹ چھوڑ دیتا ہے جس کی دستی مرمت (manual repair) کی ضرورت پڑتی ہے۔ امیج ٹیگ کو اگلے میجر ورژن کے تازہ ترین ریلیز پر لائیں، اس ریلیز کے نوٹس میں بریکنگ چینجز (breaking changes) پڑھیں، docker compose up -d چلائیں، اور اگلا قدم اٹھانے سے پہلے لاگز میں migration مکمل ہونے کا انتظار کریں۔ دوسرا، MongoDB سپورٹ میٹرکس کا احترام کریں۔ ٹارگٹ ریلیز کی انجن کی ضروریات اور Rocket.Chat کا سپورٹ ٹیبل دونوں چیک کریں: درج کردہ MongoDB ورژن ایک کم از کم ضرورت ہے، اور Rocket.Chat 8.x، MongoDB 8.0 اور اس سے اوپر کے ورژنز کو سپورٹ کرتا ہے، جس کی تصدیق 8.2 کے ساتھ کی گئی ہے۔ جب آپ MongoDB کو اپ گریڈ کریں، مثلاً 7.0 سے 8.0 پر، تو ایک وقت میں ایک میجر ورژن آگے بڑھیں اور ہر تبدیلی کے بعد feature-compatibility ورژن سیٹ کریں۔ MongoDB 8.0 پر اس کمانڈ کے لیے ایک واضح confirm: true درکار ہوتا ہے، ورنہ یہ اس پیغام کے ساتھ مسترد ہو جاتا ہے کہ آپ اسے تصدیقی فلیگ کے ساتھ دوبارہ چلائیں:
sudo docker compose exec mongodb mongosh --eval 'db.adminCommand({setFeatureCompatibilityVersion: "8.0", confirm: true})'ہر جزو (component) کے اپ گریڈ سے پہلے mongodump لیں۔ اپنی Compose کنفیگریشن اور کسی بھی بیرونی اپ لوڈ اسٹور کو بھی محفوظ کریں، تاکہ بیک اپ پورے ڈپلائمنٹ کا احاطہ کر سکے۔
ناکامی کے طریقے، درست strings کے ساتھ
Rocket.Chat docker compose up کے فوراً بعد restart-loop میں چلا جاتا ہے، اور docker compose logs rocketchat ایک MongoServerSelectionError سے بھر جاتا ہے۔ ڈرائیور مناسب MongoDB سرور کا انتخاب نہیں کر پا رہا؛ وجہ جاننے کے لیے topology کی تفصیل اور بنیادی errors کا معائنہ کریں۔ ReplicaSetNoPrimary کی topology قسم کے ساتھ Server selection timed out after 30000 ms کا مطلب ہے کہ ڈرائیور جانتا ہے کہ وہ replica set سے جڑ رہا ہے لیکن اسے کوئی primary معلوم نہیں؛ اس کی ممکنہ وجوہات initialization کا نہ ہونا، election کا عمل، یا primary تک رسائی نہ ہونا ہیں۔ getaddrinfo ENOTFOUND کے بعد ایک بے ترتیب hash کا مطلب ہے کہ advertised member کا hostname حل نہیں ہو رہا۔ sudo docker compose exec mongodb mongosh --eval 'rs.status()' کے ساتھ تشخیص کریں: اگر یہ MongoServerError: no replset config has been received error دے تو set کو initiate کریں؛ اگر یہ ایسا member دکھائے جس کا name ایک بے ترتیب hash ہو، تو rs.conf() کے ساتھ configuration حاصل کریں، اس member کا host تبدیل کر کے mongodb:27017 کریں، اور primary پر rs.reconfig() کے ساتھ اسے apply کریں۔ اگر configuration درست ہے تو member کی حالت، MongoDB کے logs، اور Rocket.Chat container سے connectivity چیک کریں۔
ویب UI لوڈ ہوتا ہے لیکن لاگ ان ہمیشہ گھومتا رہتا ہے اور مکمل نہیں ہوتا۔ براؤزر کنسول کھولیں، آپ کو WebSocket connection to 'wss://chat.example.com/websocket' failed نظر آئے گا۔ یہ تقریباً ہمیشہ ROOT_URL کا فرق ہوتا ہے یا کوئی ایسا proxy جو upgrade headers کو آگے نہیں بھیج رہا۔ تصدیق کریں کہ ROOT_URL بالکل public address کے برابر ہے جس میں https:// شامل ہے، اور یہ کہ آپ کا nginx location بلاک Upgrade اور Connection "upgrade" کو proxy_http_version 1.1 کے ساتھ سیٹ کرتا ہے۔ 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 کے ساتھ ناکام ہو جاتا ہے۔ کوئی چیز پہلے سے port 3000 استعمال کر رہی ہے، اکثر یہ پچھلا Rocket.Chat container ہوتا ہے جو صحیح طریقے سے بند نہیں ہوا، یا کوئی اور ایپ۔ اسے sudo ss -ltnp | grep :3000 کے ساتھ تلاش کریں، اس process یا container کو بند کریں، یا mapping کے host سائیڈ کو 127.0.0.1:3001:3000 میں تبدیل کریں اور اپنے proxy کے proxy_pass کو اس کے مطابق اپ ڈیٹ کریں۔
FAQ
کیا Rocket.Chat کو واقعی MongoDB replica set کی ضرورت ہے؟
جی ہاں، ایک ہی سرور پر ایک ڈیٹا بیس نوڈ کے ساتھ بھی۔ Rocket.Chat ریئل ٹائم میں پیغامات کی ترسیل کے لیے MongoDB change streams استعمال کرتا ہے، جن کے لیے replica set یا sharded cluster درکار ہوتا ہے؛ ایک اسٹینڈ الون mongod اسے اوپن نہیں کر سکتا۔ آپ کو متعدد مشینوں کی ضرورت نہیں ہے؛ آپ --replSet rs0 کے ساتھ شروع کردہ ایک MongoDB کنٹینر چلائیں اور rs.initiate() کے ساتھ ایک ممبر پر مشتمل سیٹ کو انیشلائز کریں۔ اگر آپ یہ مرحلہ چھوڑ دیں گے تو ڈرائیور کو کبھی primary نہیں ملے گا، جس کی وجہ سے Rocket.Chat MongoServerSelectionError: Server selection timed out کے ساتھ ری اسٹارٹ لوپ میں پھنس جائے گا اور کبھی بوٹ مکمل نہیں کر پائے گا۔
سیلف ہوسٹڈ Rocket.Chat کو کتنی RAM درکار ہوتی ہے؟
عملی طور پر کم از کم 4 GB اور مصروف ٹیم کے لیے 8 GB کا منصوبہ بنائیں۔ Rocket.Chat کا Node پروسیس تقریباً 1 سے 1.5 GB استعمال کرتا ہے، اور MongoDB کا ڈیفالٹ WiredTiger کیشے (کل RAM مائنس 1 GB) کا نصف ہوتا ہے، جس کا سائز اس طرح رکھا جاتا ہے جیسے باکس پر کچھ اور نہ چل رہا ہو۔ 2 GB کے باکس پر وہ کیشے، Node کا ہیپ اور خود mongod کا اوور ہیڈ آپس میں ٹکراتے ہیں، اور آؤٹ آف میموری کلر کسی بھی حقیقی لوڈ کے تحت mongod کو ختم کر دیتا ہے، جس سے لاگز میں Killed اور ایگزٹ کوڈ 137 ظاہر ہوتا ہے۔ 2 GB صرف چند ٹیسٹ صارفین کے ساتھ سافٹ ویئر کو جانچنے کے لیے کافی ہے۔
میں Rocket.Chat کو HTTPS کے پیچھے کیسے رکھوں؟
اسی VPS پر ایک ریورس پراکسی چلائیں جو TLS کو ٹرمینیٹ کرے اور 127.0.0.1:3000 پر فارورڈ کرے، اور کنٹینر کے ROOT_URL کو اپنے پبلک https:// ایڈریس پر سیٹ کریں۔ پراکسی کو WebSocket اپ گریڈ ہیڈرز کو فارورڈ کرنا لازمی ہے ورنہ لاگ ان ہینگ ہو جائے گا۔ Nginx کے ساتھ Certbot سنگل ایپ کے لیے سب سے سادہ سیٹ اپ ہے؛ اگر آپ ایک پراکسی کے پیچھے کئی کنٹینرز چلاتے ہیں اور خودکار سرٹیفکیٹ مینجمنٹ چاہتے ہیں تو Traefik زیادہ بہتر ہے۔
میں سیلف ہوسٹڈ Rocket.Chat کا بیک اپ کیسے لوں؟
صرف ڈیٹا بیس کا یہ ڈمپ لینے سے پہلے Rocket.Chat اور ڈیٹا بیس میں لکھنے والے کسی بھی دوسرے عمل کو روک دیں: docker compose exec -T mongodb mongodump --db rocketchat --archive --gzip > backup.archive.gz۔ ڈمپ کامیاب ہونے کے بعد Rocket.Chat کو دوبارہ شروع کریں۔ اس آرکائیو میں صارفین، چینلز، پیغامات، اور سیٹنگز شامل ہوتی ہیں، نیز اگر آپ نے اسٹوریج GridFS پر چھوڑی ہے تو اپ لوڈ کردہ فائلیں بھی۔ اسے سرور سے باہر کاپی کریں، cron کے ساتھ اسے ہر رات خودکار بنائیں، اور ایک عارضی باکس پر mongorestore کی مشق کریں تاکہ آپ کو معلوم ہو کہ بحالی (restore) واقعی کام کرتی ہے۔
میں MongoDB کو توڑے بغیر Rocket.Chat کو اپ گریڈ کیسے کروں؟
Rocket.Chat کو ایک وقت میں ایک میجر ورژن اپ گریڈ کریں، یہ بوٹ کے وقت مائیگریشنز چلاتا ہے اور اس کے دستاویزات خبردار کرتے ہیں کہ میجر ورژنز کو چھوڑنے سے شدید مطابقت کے مسائل پیدا ہو سکتے ہیں، اس لیے پن شدہ امیج ٹیگ کو تبدیل کرنے سے پہلے ہر ریلیز کے نوٹس پڑھیں۔ ٹارگٹ ریلیز کی انجن ضروریات کو Rocket.Chat کے MongoDB سپورٹ ٹیبل سے چیک کریں؛ Rocket.Chat 8.x، MongoDB 8.0 اور اس سے اوپر کو سپورٹ کرتا ہے، جس کی تصدیق 8.2 کے ساتھ کی گئی ہے۔ جب آپ MongoDB کو منتقل کریں، تو ایک وقت میں ایک میجر ورژن آگے بڑھیں اور ہر ہاپ کے بعد setFeatureCompatibilityVersion سیٹ کریں؛ MongoDB 7.0 اور بعد کے ورژنز کے لیے confirm: true درکار ہوتا ہے۔ ہمیشہ پہلے mongodump لیں۔