Dokploy, Docker Swarm, Traefik ve HTTPS ile nasıl kurulur

Dokploy, açık kaynaklı ve kendi sunucunuzda barındırabileceğiniz bir dağıtım platformudur. Uygulamaları Git depolarından, Dockerfile'lardan ve Docker Compose dosyalarından derleyip çalıştırır, veritabanları hazırlar ve alan adlarınızı otomatik Let's Encrypt sertifikalarıyla Traefik üzerinden yönlendirir. Arka planda sunucunuzu bir Docker Swarm yöneticisine dönüştürür; bu da ileride başka sunucuları yönetmesini mümkün kılar.

Bu rehber Dokploy'u, siz indirip okuduktan sonra resmi kurulum betiğiyle kurar, yöneticiyi oluşturur, paneli HTTPS ile kendi alan adınıza taşır, genel 3000 portunu kaldırır ve instance, veritabanları ve volume'lar için Dokploy'un S3 yedeklerini ayarlar. Son olarak güncelleme yöntemini ve sık görülen sorunların çözümlerini ele alır.

Adım 1 — Güvenlik duvarını hazırlayın

SSH, HTTP, HTTPS'e ve yalnızca ilk kurulum için panel portu 3000'e izin verin:

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

İki noktaya dikkat edin. Birincisi, Dokploy 3000 portunu, Traefik ise 80 ve 443 portlarını Docker üzerinden yayınlar; Docker belgeleri yayınlanan portlara gelen paketlerin ufw kuralları uygulanmadan önce yönlendirildiğini açıklar. Bu nedenle ufw 3000 portunu kapatamaz; onu Adım 6 kaldırır, sağlayıcının ağ güvenlik duvarı da ikinci bir katman ekler. İkincisi, kurulum betiği 2377/tcp, 7946/tcp ve udp ile 4789/udp portlarında dinleyen bir Docker Swarm oluşturur. Bunları internete kapalı tutun: Docker'ın Swarm belgeleri VXLAN portu 4789'un güvenilmeyen ağlara asla açılmaması gerektiğini söyler. ufw'nin varsayılan reddetme politikası bunları zaten engeller; ileride sunucu eklerseniz yalnızca kendi düğümleriniz arasında açın.

Adım 2 — Kurulum betiğini indirin ve inceleyin

Resmi betiği indirin ve root olarak çalıştırmadan önce okuyun:

curl -sSL https://dokploy.com/install.sh -o dokploy-install.sh
less dokploy-install.sh

Ekim 2026 itibarıyla betik şunları yapar:

• GitHub'dan en son kararlı Dokploy sürümünü seçer (ayarlıysa DOKPLOY_VERSION değerini kullanır);
• root olarak çalışmıyorsa, macOS'ta veya bir konteyner içindeyse sonlanır; 80, 443 veya 3000 portları kullanımdaysa da sonlanır;
• Docker yoksa Docker'ın 28.5.0 sürümüne sabitlenmiş kolaylık betiğiyle kurar ve apt tabanlı sistemlerde docker-ce, docker-ce-cli ve docker-ce-rootless-extras paketlerini bekletmeye (hold) alır;
• docker swarm leave --force çalıştırır, ardından bir duyuru adresiyle docker swarm init yapar: ilk özel IPv4 adresini, yoksa ifconfig.io veya icanhazip.com üzerinden öğrendiği genel IP'yi kullanır;
• bağlanılabilir dokploy-network overlay ağını ve /etc/dokploy klasörünü oluşturur;
• PostgreSQL parolasını ve bir kimlik doğrulama sırrını üretip Docker secret olarak saklar; bu değerler hiçbir zaman ekrana yazılmaz;
• dokploy-postgres (PostgreSQL 16) ve dokploy (3000 portunda yayınlanan panel) Swarm servislerini ve dokploy-traefik konteynerini (80 ve 443 portlarında Traefik v3) başlatır.

Dokploy, 0.29.9 sürümünden beri kendi sunucunuzdaki kurulumlarda Redis kullanmaz.

Adım 3 — Kurulum betiğini çalıştırın

İncelediğiniz betiği root olarak çalıştırın:

sudo sh dokploy-install.sh

Sunucunun birden fazla adresi varsa veya betik bir adres belirleyemezse, Swarm'ın duyuracağı adresi kendiniz ayarlayın:

sudo ADVERTISE_ADDR=203.0.113.10 sh dokploy-install.sh

Betik sonunda http://sunucu-ip-adresiniz:3000 adresini yazdırır ve yaklaşık 15 saniye beklemenizi ister. Servisleri ve Traefik konteynerini kontrol edin:

sudo docker service ls
sudo docker ps

dokploy ve dokploy-postgres servisleri 1/1 replika göstermeli, dokploy-traefik ise Up durumunda olmalıdır.

Adım 4 — Yönetici hesabını oluşturun

http://sunucu-ip-adresiniz:3000 adresini hemen açın. İlk ziyarette yönetici hesabını oluşturduğunuz kurulum sayfası görünür: adınızı, e-posta adresinizi ve uzun, benzersiz bir parolayı girin. Bu sayfaya sizden önce ulaşan herkes instance'ı sahiplenebilir; bu yüzden sayfayı bekletmeyin.

Giriş yaptıktan sonra:

1. Profilinizde iki adımlı doğrulamayı açın.
2. Diğer kişileri yönetici girişini paylaşmak yerine Settings, Users altından davet edin ve onlara yalnızca ihtiyaç duydukları rolleri verin.

Adım 5 — Paneli alan adınızda HTTPS ile sunun

Dokploy belgeleri, alan adını eklemeden önce DNS'in sunucuyu göstermesi gerektiğini vurgular; aksi hâlde sertifika oluşturulmaz. dokploy.example.com adının sunucunuza çözümlendiğini doğrulayın, ardından:

1. Settings ve ardından panelin kendi alan adı, sertifika ve bakım ayarlarını içeren Web Server bölümünü açın.
2. Host olarak dokploy.example.com girin, HTTPS'i açın, sertifika türü olarak Let's Encrypt seçin ve Let's Encrypt bildirimleri için bir e-posta adresi girin.
3. Kaydedin. Traefik sertifikayı ister.

Bilgisayarınızdan kontrol edin:

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

Geçerli bir sertifikayla HTTPS üzerinden bir yanıt almalısınız. Devam etmeden önce yeni adres üzerinden giriş yapın.

Adım 6 — 3000 portunu kapatın

Panel HTTPS üzerinde çalıştığında, Dokploy belgelerindeki komutla yayınlanan 3000 portunu kaldırın ve geçici ufw kuralını silin:

sudo docker service update --publish-rm "published=3000,target=3000,mode=host" dokploy
sudo ufw delete allow 3000/tcp

Başka bir makineden nc -vz sunucu-ip-adresiniz 3000 artık reddedilmeli veya zaman aşımına uğramalı, https://dokploy.example.com ise açılmaya devam etmelidir. Doğrudan erişime yeniden ihtiyaç duyarsanız portu aynı tanımla --publish-add kullanarak geçici olarak yayınlayın.

Yedekleme ve geri yükleme

Dokploy'un tüm yedekleri S3 uyumlu depolamaya gider; bu yüzden işe bir hedef ekleyerek başlayın: Settings ve ardından S3 Destinations bölümünü açın, depolama sağlayıcınızın erişim anahtarını, gizli anahtarını, bucket adını, bölgesini ve uç noktasını girin.

Instance yedeği. Web Server altında Backups bölümünü açın, Create Backup seçin, hedefi ve isteğe bağlı olarak 0 3 * * * gibi bir cron zamanlamasını belirleyin. Her çalıştırma dokploy-postgres veritabanını ve /etc/dokploy klasörünü (Traefik yapılandırması dahil) tek bir sıkıştırılmış .zip dosyasında toplar ve yükler.

Veritabanı yedekleri. Dokploy'da oluşturduğunuz her veritabanı için Backup sekmesini açın, hedefi seçin; Database Name, Schedule Cron ve Prefix alanlarını doldurun. Enabled seçeneğini açık bırakın ve bucket'a ilk yedeği göndermek için Test seçin.

Volume yedekleri. Uygulamaların ve Compose servislerinin adlandırılmış Docker volume'ları için Volume Backups bölümünü kullanın: işe bir ad verin, servisi ve volume'u seçin, bir zamanlama belirleyin ve dosyaların tutarlı olması için Turn off Container seçeneğini seçili tutun. Bind mount'lar desteklenmez; önce adlandırılmış volume'lara geçin.

Yapılandırma klasörünün yerel bir kopyası, örneğin Traefik ayarlarını değiştirmeden önce, faydalı bir ektir:

sudo mkdir -p /opt/backups
sudo tar czf /opt/backups/dokploy-etc-$(date +%F).tar.gz /etc/dokploy

Geri yükleme. Instance'ı geri yüklemek için Web Server, ardından Backups bölümünü açın, Restore Backup seçin, hedefi ve dosyayı seçip özeti inceleyin. Geri yükleme /etc/dokploy içeriğini değiştirir, dokploy-postgres veritabanını silip yeniden kurar ve mevcut oturumları keser; ardından yeniden giriş yapın, yönlendirmeler hatalı çalışırsa Traefik'i yeniden başlatın. Yeni bir sunucuda önce Dokploy'u kurun, aynı S3 hedefini ekleyin, geri yükleyin; ardından sunucu ayarlarındaki Update IP ile IP'yi güncelleyin, DNS kayıtlarınızı değiştirin ve IP adresi kullanan Git sağlayıcılarını yeniden yapılandırın. Veritabanları kendi Backup sekmesindeki Restore ile; volume'lar ise henüz var olmayan bir volume adına, konteynerleri durdurulmuşken Restore Volume ile geri yüklenir.

Dokploy güncelleme

Dokploy'un GitHub sürümler sayfasındaki sürüm notlarını okuyun (Ekim 2026 başında en son sürüm 0.30.8 idi) ve önce bir instance yedeği alın. Ardından betiği yeniden indirip update komutunu çalıştırın:

curl -sSL https://dokploy.com/install.sh -o dokploy-install.sh
sudo sh dokploy-install.sh update
sudo docker service ls

Resmi tek satırlık biçimi curl -sSL https://dokploy.com/install.sh | sh -s update komutudur. update komutu yeni dokploy/dokploy imajını çeker ve yalnızca dokploy servisini günceller; Dokploy'un elle kurulum sayfasında ayrıca ele alınan PostgreSQL'e ve Traefik'e dokunmaz. Docker'ı sizin için kurulum betiği kurduysa Docker paketleri sabitlenen sürümde bekletmededir; bu yüzden apt upgrade Docker'ı güncellemez. Bu bekletmeyi apt-mark unhold ile kaldırmadan önce Dokploy belgelerini kontrol edin.

Sorun giderme

Kurulum betiği 80, 443 veya 3000 portu kullanımda olduğu için duruyor

Dokploy'un portlarından birinde zaten bir şey dinliyor. sudo ss -tulnp | grep -E ':(80|443|3000) ' ile bulun, o servisi (genellikle Apache, Nginx veya Caddy) durdurup devre dışı bırakın ve kurulum betiğini yeniden çalıştırın.

Swarm başlatma başarısız oluyor veya panel yanlış IP adresi gösteriyor

Betik kullanılabilir bir adres bulamadı ya da istemediğiniz özel bir adresi seçti. Adım 3'teki gibi ADVERTISE_ADDR değerini sunucunun genel IP adresine ayarlayarak yeniden çalıştırın.

Yeniden başlatmadan sonra panel açılmıyor

Konteynerler yanlış sırayla başlamış ve Dokploy, PostgreSQL hazır olmadan ayağa kalkmış olabilir. Logları okuyun, ardından panel servisini yeniden başlatın:

sudo docker service logs dokploy --tail 50
sudo docker service logs dokploy-postgres --tail 50
sudo docker logs dokploy-traefik --tail 50
sudo docker service scale dokploy=0
sudo docker service scale dokploy=1

Dolu bir disk de Dokploy veritabanını kurtarma moduna sokabilir; boş alanı df -h ile kontrol edin.

Let's Encrypt sertifika vermiyor

Alan adı büyük olasılıkla DNS kaydı sunucuyu göstermeden önce eklendi. Kaydı düzeltin, ardından alan adını Dokploy'da yeniden oluşturun veya Traefik'i sudo docker restart dokploy-traefik ile yeniden başlatın. 80 ve 443 portlarının sağlayıcınızın güvenlik duvarında da açık olduğundan emin olun.

Disk imajlar ve derleme önbelleğiyle doluyor

Dokploy'un sorun giderme sayfası Docker'ın prune komutlarını kullanır; örneğin derleme önbelleği için sudo docker builder prune -a, kullanılmayan imajlar için sudo docker image prune -a. Önce alanı neyin kullandığını sudo docker system df ile görün; prune -a şu anda hiçbir konteynerin kullanmadığı tüm imajları siler.

Yönetici parolasını unuttunuz

dokploy servisinin konteynerini bulun (imajı dokploy/dokploy olandır) ve Dokploy'un sıfırlama komutunu içinde çalıştırın:

sudo docker ps --filter name=dokploy
sudo docker exec -it CONTAINER_ID bash -c "pnpm run reset-password"

CONTAINER_ID yerine ilk komuttaki kimliği yazın. İki adımlı doğrulama için pnpm run reset-2fa aynı şekilde çalışır.

Sonraki adımlar

• Kendi sunucunuzda barındırılan başka bir platformla karşılaştırmak için Coolify kurulumu rehberine bakın.
• Traefik'in alan adlarını nasıl yönlendirdiğini Traefik reverse proxy rehberinde öğrenin.
• Derleme iş yükleri için boyutlandırılmış sunuculara Dokploy hosting sayfasında göz atın.
• Uygulamalar, Compose dağıtımları ve uzak sunucular için resmi Dokploy belgelerini okuyun.