Rocket.Chat Docker Compose ve HTTPS ile nasıl kurulur

Rocket.Chat; kanallar, doğrudan mesajlar, mesaj dizileri, dosya paylaşımı, video konferans entegrasyonları ve müşteri konuşmaları için bir omnichannel modülü sunan açık kaynaklı bir ekip sohbet platformudur. Bu rehber Rocket.Chat'i resmi rocketchat-compose projesiyle Ubuntu veya Debian üzerine kurar: Rocket.Chat konteyneri, replica set olarak çalışan MongoDB, NATS mesaj aracısı ve Let's Encrypt sertifikasını kendisi alan Traefik. Ardından ilk yöneticiyi oluşturur, kayıt formunu kapatır ve çalışma alanını nasıl yedekleyeceğinizi, geri yükleyeceğinizi ve güncelleyeceğinizi öğrenirsiniz.

Adım 1 — Resmi Compose projesini klonlayın

Uygulama klasörünü oluşturun ve depoyu içine klonlayın:

sudo mkdir -p /opt/rocketchat
sudo chown $USER:$USER /opt/rocketchat
git clone --depth 1 https://github.com/RocketChat/rocketchat-compose.git /opt/rocketchat
cd /opt/rocketchat
cp .env.example .env
chmod 600 .env
ls

Proje yığını birkaç Compose dosyasına böler:

• compose.yml — Rocket.Chat uygulaması,
• compose.database.yml — MongoDB, veri klasörü izinlerini düzelten bir yardımcı ve replica set'i ilklendiren tek seferlik bir konteyner,
• compose.nats.yml — NATS mesaj aracısı,
• compose.traefik.yml — Let's Encrypt'li Traefik,
• compose.monitoring.yml ve docker.yml — isteğe bağlı Prometheus, Loki ve Grafana izleme yığını.

Rocket.Chat bu dosyaları düzenlememenizi önerir. Değiştirdiğiniz her şey .env dosyasına girer.

Adım 2 — .env dosyasını yapılandırın

Dosyayı nano .env ile açın. Mevcut değerleri değiştirin ve eksik satırları ekleyin:

RELEASE=8.8.1
DOMAIN=chat.example.com
ROOT_URL=https://chat.example.com
LETSENCRYPT_ENABLED=true
LETSENCRYPT_EMAIL[email protected]
TRAEFIK_PROTOCOL=https
BIND_IP=127.0.0.1
TRAEFIK_DASHBOARD_PORT=127.0.0.1:8080
MONGODB_VERSION=8.0
COMPOSE_FILE=compose.traefik.yml:compose.database.yml:compose.yml:compose.nats.yml

Bu ayarların işlevi:

• RELEASE, Rocket.Chat sürümünü sabitler. Rocket.Chat üretimde latest yerine sabit bir sürüm numarasını şiddetle önerir. En yeni sürümü desteklenen sürümler sayfasından alın; bu rehber yazılırken güncel sürüm 8.8.1 idi.
• DOMAIN ve ROOT_URL genel adresle eşleşmelidir. Traefik sertifikayı DOMAIN için ister, Rocket.Chat ise bağlantıları ROOT_URL üzerinden oluşturur.
• LETSENCRYPT_ENABLED, LETSENCRYPT_EMAIL ve TRAEFIK_PROTOCOL=https, Traefik'i Let's Encrypt sertifikalı HTTPS'e geçirir.
• BIND_IP=127.0.0.1 güvenlik açısından önemlidir. compose.yml, 3000 numaralı portu ve metrik portunu varsayılan olarak tüm adreslerde yayınlar ve Docker'ın yayınladığı portlar ufw'yi atlar. Traefik Rocket.Chat'e Compose ağı üzerinden ulaşır; bu nedenle ana makinedeki portun yalnızca localhost'ta dinlemesi yeterlidir.
• TRAEFIK_DASHBOARD_PORT=127.0.0.1:8080, Traefik panel portunu localhost'ta tutar. Panel varsayılan olarak kapalıdır, ancak port eşlemesi aksi hâlde 8080'i yine tüm adreslerde açardı.
• MONGODB_VERSION=8.0, Rocket.Chat 8.x için en düşük MongoDB sürümüyle eşleşir. Her sürüm uyumlu MongoDB sürümlerini bildirir: curl -s https://releases.rocket.chat/8.8.1/info bunları compatibleMongoVersions alanında gösterir.
• COMPOSE_FILE, docker compose komutuna yığını hangi dosyaların oluşturduğunu söyler; böylece sonraki her komut -f seçenekleri olmadan aynı dosya kümesini kullanır. Deponun README dosyası, bileşenlerin dosyalarını dışarıda bırakarak bileşenleri çıkarabileceğinizi söyler; bu liste izleme yığınını dışarıda bırakır.

Compose'un yapılandırmayı okuyabildiğini kontrol edin:

docker compose config --services

Liste traefik, mongodb, rocketchat ve nats servislerini içermelidir. Burada çıkan bir hata genellikle .env içindeki bir yazım hatasını gösterir.

Adım 3 — Güvenlik duvarını açın

Yalnızca SSH ve web trafiğine izin verin:

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose

Traefik, alan adını denetlediğinizi kanıtlamak için 443 numaralı portta TLS doğrulamasını kullanır; bu yüzden ilk başlatmadan önce 443 portuna erişilebilmeli ve DNS bu sunucuyu göstermelidir. Resmi dosyalar MongoDB ve NATS'i yalnızca 127.0.0.1 üzerinde yayınlar; Adım 2 de Rocket.Chat'in kendi portlarını oraya taşıdı.

Adım 4 — Rocket.Chat'i başlatın

İmajları çekin ve yığını başlatın:

cd /opt/rocketchat
docker compose pull
docker compose up -d
docker compose ps -a
docker compose logs -f rocketchat

rocketchat, mongodb, nats ve traefik gibi konteynerler Up durumunda olmalıdır. İzin yardımcısı ve replica set ilklendirme konteyneri işlerini bitirip Exited (0) gösterir; bu beklenen durumdur. Rocket.Chat, logunda bir SERVER RUNNING kutusu göründüğünde hazırdır; logu izlemeyi bırakmak için Ctrl+C tuşlarına basın.

HTTPS'i ve kapalı uygulama portunu kontrol edin:

curl -I https://chat.example.com

Yanıt geçerli bir sertifikayla HTTP/2 200 olmalıdır. Başka bir makineden nc -vz sunucu-ip-adresiniz 3000 reddedilmeli veya zaman aşımına uğramalıdır.

Adım 5 — Kurulum sihirbazını çalıştırın ve kayıt formunu kapatın

https://chat.example.com adresini açın. Kurulum sihirbazı önce ilk yöneticiyi (ad, kullanıcı adı, e-posta ve parola), sonra kuruluş bilgilerinizi ister ve ardından çalışma alanını e-posta adresinizle Rocket.Chat Cloud'a kaydeder. Kaydı tamamlamak için Rocket.Chat'in gönderdiği e-postayı onaylayın.

Rocket.Chat'in çalışma alanı SSS sayfası, kayıt formunun genellikle Public olarak ayarlı olduğunu belirtir; bu da adresi bulan herkesin hesap oluşturabilmesi demektir. Bağlantıyı paylaşmadan önce formu kapatın:

1. Manage > Workspace > Settings > Accounts sayfasına gidin.
2. Registration bölümüne inin ve Registration Form ayarını Disabled yapın.
3. Kaydedin, ardından kullanıcıları Manage > Workspace > Users sayfasından davet edin.

Mevcut kullanıcılar her zamanki gibi giriş yapmaya devam eder. Ayarlardayken her yönetici hesabında iki faktörlü kimlik doğrulamayı açın ve File Upload bölümünü gözden geçirin: dosyalar varsayılan olarak MongoDB GridFS içinde saklanır ve Rocket.Chat üretim için S3 veya MinIO gibi nesne depolamayı önerir (Self-hosted S3 depolama rehberine bakın).

Rocket.Chat davetleri, parola sıfırlamalarını, adres doğrulamalarını ve kaçırılan mesaj bildirimlerini Manage > Workspace > Settings > Email altındaki SMTP bölümünde ayarladığınız relay üzerinden e-postayla gönderir (protokol smtp, sunucu smtp.example.com, port 587, SMTP kullanıcı adınız ve parolanız ile bir From Email adresi).

Yedekleme ve geri yükleme

Varsayılan GridFS depolamada her şeyi MongoDB tutar: kullanıcılar, mesajlar, ayarlar ve yüklenen dosyalar. .env dosyası ise kurulum ayarlarınızı tutar. Rocket.Chat'in rehberi veritabanını ana makineye akıtılan mongodump ile yedekler:

sudo mkdir -p /opt/backups
sudo chown $USER:$USER /opt/backups
chmod 700 /opt/backups
cd /opt/rocketchat
docker compose exec -T mongodb sh -c 'mongodump --archive' > /opt/backups/rocketchat-db-$(date +%F).archive
cp .env /opt/backups/rocketchat-env-$(date +%F)
ls -lh /opt/backups

-T sözde terminali (pseudo-terminal) kapatır; böylece ikili arşiv dosyaya değişmeden ulaşır. Dosya yüklemelerini FileSystem depolama türüne geçirdiyseniz o klasörü de arşivleyin; S3 veya MinIO kullanıyorsanız kovayı (bucket) depolama sağlayıcınızın araçlarıyla yedekleyin.

Geri yüklemek için aynı RELEASE ve MONGODB_VERSION değerleriyle çalışan bir yığından başlayın (yeni bir sunucuda Adım 1–4'ü kaydettiğiniz .env ile tekrarlayın). Rocket.Chat'i durdurun, arşivi yükleyin ve yeniden başlatın:

cd /opt/rocketchat
docker compose stop rocketchat
docker compose exec -T mongodb sh -c 'mongorestore --archive --drop' < /opt/backups/rocketchat-db-2026-10-09.archive
docker compose start rocketchat

Yedekleri sunucunun dışına da kopyalayın.

Rocket.Chat güncelleme

Rocket.Chat'in güncelleme yönergeleri dört kurala dayanır: sürüm notlarını okuyun, önce yedek alın, yeni sürüm gerektiriyorsa MongoDB'yi Rocket.Chat'ten önce güncelleyin ve ana sürümler arasında birer birer ilerleyin (7.x'ten 8.x'e; asla 6.x'ten doğrudan 8.x'e değil). Aynı ana sürüm içindeki ara sürüm ve yama güncellemeleri doğrudan uygulanabilir.

cd /opt/rocketchat
curl -s https://releases.rocket.chat/8.8.1/info
nano .env
docker compose pull
docker compose up -d
docker compose ps

curl komutundaki 8.8.1 değerini hedef sürümle değiştirin ve compatibleMongoVersions alanını kontrol edin. .env içinde RELEASE değerini yeni sürüme ayarlayın. Sürüm daha yeni bir MongoDB gerektiriyorsa önce MONGODB_VERSION değerini değiştirin, docker compose up -d mongodb çalıştırın ve konteynerin sağlıklı duruma gelmesini bekleyin. COMPOSE_FILE tüm dosyalarınızı listelediği için docker compose up -d yığını aynı servislerle yeniden oluşturur; Rocket.Chat'in rehberi bir dosyayı dışarıda bırakmanın o servisleri düşürdüğü konusunda uyarır. Ardından sürümü Manage > Workspace altında doğrulayın.

MongoDB doğrudan eski sürüme düşürülemez; geri dönmek için önce özellik uyumluluk sürümünü (feature compatibility version) düşürmek gerekir. Bu yüzden güncellemeden önce aldığınız yedeği saklayın.

Sorun giderme

Traefik sertifika alamıyor

docker compose logs traefik çalıştırın. Olağan nedenler henüz bu sunucuyu göstermeyen bir DNS kaydı, sunucunun önündeki bir güvenlik duvarında engellenmiş 443 portu veya tekrarlanan denemelerden sonra Let's Encrypt hız sınırlarıdır. Nedeni giderin, ardından docker compose restart traefik çalıştırın.

mongodb konteyneri sürekli yeniden başlıyor

docker compose logs mongodb çıktısını okuyun. MongoDB, izin yardımcısının veri klasörünün sahipliğini düzeltmesini yaklaşık beş dakikaya kadar bekler ve bu başarısız olursa kapanır. Ubuntu 26.04'te MongoDB 8.x hiç başlamayabilir; bunun yerine Ubuntu 24.04 LTS veya Debian kullanın.

Rocket.Chat bir güncellemeden sonra MongoDB sürüm hatasıyla kapanıyor

Yeni sürüm daha yeni bir MongoDB gerektiriyor. Sürüm için compatibleMongoVersions alanını kontrol edin, .env içinde MONGODB_VERSION değerini yükseltin, önce docker compose up -d mongodb ile MongoDB'yi güncelleyin, ardından Rocket.Chat'i yeniden başlatın.

3000 numaralı porta internetten erişilebiliyor

.env dosyasında BIND_IP eksik; bu yüzden Docker portu tüm adreslerde yayınlıyor ve ufw onu engellemiyor. BIND_IP=127.0.0.1 ekleyin ve konteyneri yeniden oluşturmak için docker compose up -d çalıştırın.

Anlık bildirimler telefonlara ulaşmıyor

Anlık bildirimler, desteklenen bir sürümde kayıtlı bir çalışma alanı gerektiren Rocket.Chat bulut ağ geçidinden geçer. Kayıt durumunu Manage > Workspace altında kontrol edin, çalışma alanını yeniden kaydedin veya eşitleyin ve sürümünüzün destek süresi dolduysa güncelleyin.

Sonraki adımlar

• Rocket.Chat'i Mattermost ve Element ile Matrix Synapse ile karşılaştırın.
• Jitsi Meet ile video toplantılar ekleyin.
• Burada kullanılan Compose komutlarını Docker Compose temelleri rehberinde öğrenin.
• İzleme, harici MongoDB ve ölçekleme için resmi Rocket.Chat Docker kurulum rehberini okuyun.
• Ekip sohbeti için sunucuları team chat hosting sayfasında karşılaştırın.