Docker ile tek komutla kurulum

Bu rehberin sonunda Bekci sunucunuzda çalışıyor olacak ve paneli http://SUNUCU-IP:8080 adresinden açabileceksiniz. Toplam süre: yaklaşık 3 dakika.

1. Docker'ı kurun#

Önce sunucunuzda Docker olup olmadığına bakın:

docker --version

Bir sürüm numarası görüyorsanız (ör. Docker version 29.x) bu adımı atlayın. command not found görüyorsanız Docker'ı resmi kurulum betiğiyle kurun:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Bu betik Docker'ın kendi hazırladığı betiktir (get.docker.com); Ubuntu, Debian, Fedora, CentOS/RHEL gibi yaygın dağıtımlarda Docker Engine'i ve Compose eklentisini kurar. Dağıtımınızın paket deposuyla kurmayı tercih ederseniz Docker'ın kurulum belgelerini izleyin.

2. Bekci'yi başlatın#

Aşağıdaki komutun tamamını kopyalayıp sunucunuzda çalıştırın:

docker run -d --name bekci --restart unless-stopped \
  -p 8080:8080 \
  -v bekci-data:/data \
  kadirsungurlu/bekci:latest

Komutun parçaları ne işe yarar:

3. Paneli açın ve yönetici hesabını oluşturun#

1. Tarayıcınızda http://SUNUCU-IP:8080 adresini açın. Sunucunuzun IP adresini barındırma sağlayıcınızın panelinde görebilirsiniz; sunucuda hostname -I komutunun yazdığı ilk adres de genellikle budur.
2. Hoş geldiniz ekranında bir kullanıcı adı (3–32 karakter: harf, rakam, nokta, tire, alt çizgi) ve en az 8 karakterlik bir şifre girin, şifreyi Şifre (tekrar) alanına bir kez daha yazın.
3. Hesabı oluştur düğmesine basın.

4. Güvenlik duvarını kontrol edin#

Panel açılmıyorsa büyük olasılıkla 8080 portu kapalıdır.

• Barındırma sağlayıcınızın güvenlik duvarı (Hetzner, DigitalOcean, AWS “security group” vb.): 8080/TCP için gelen bağlantılara izin verin.
• ufw: Docker, yayınladığı portlar için kuralları kendisi ekler; bu yüzden -p 8080:8080 ile yayınlanan port ufw kurallarından bağımsız olarak dışarıya açıktır. Tersini isterseniz, yani paneli yalnızca sunucunun kendisinden erişilebilir yapmak için, komuttaki -p 8080:8080 kısmını -p 127.0.0.1:8080:8080 olarak değiştirin.

5. BASE_URL'i ayarlayın#

Bekci, bildirimlerdeki bağlantılar ve sunucu ajanı kurulum komutları için panelin dışarıdan açıldığı adresi bilmek ister. Bunu BASE_URL ortam değişkeniyle verirsiniz. Ortam değişkenleri konteyner oluşturulurken verildiği için konteyneri yeniden oluşturmanız gerekir; verileriniz birimde durduğu için kaybolmaz:

docker stop bekci && docker rm bekci
docker run -d --name bekci --restart unless-stopped \
  -p 8080:8080 \
  -v bekci-data:/data \
  -e BASE_URL=http://SUNUCU-IP:8080 \
  -e TZ=Europe/Istanbul \
  kadirsungurlu/bekci:latest

TZ saat dilimidir (günlük özetler ve gece yedeğinin saati için). Tüm seçenekler: Ortam değişkenleri.

Verileriniz nerede?#

Tüm veriler (veritabanı ve otomatik yedekler) bekci-data adlı Docker biriminde, konteynerin içindeki /data klasöründedir:

docker exec bekci ls -la /data

Konteyneri silmek (docker rm bekci) verileri silmez. Birimi silmek ise tüm verileri kalıcı olarak siler; bunu yalnızca Bekci'yi tamamen kaldırırken yapın. Yedekleme için: Güncelleme, yedek ve geri dönüş.

Günlük işler#

docker stop bekci          # durdur
docker start bekci         # başlat
docker restart bekci       # yeniden başlat
docker logs -f bekci       # günlükleri canlı izle (çıkmak için Ctrl+C)
docker logs --tail 50 bekci

Sağlıklı bir açılışın son satırı şöyle görünür:

level=INFO msg="Bekci başladı" sürüm=… adres=:8080 veri=/data saat_dilimi=Europe/Istanbul

Güncelleme#

Yeni imajı indirip konteyneri aynı komutla yeniden oluşturun:

docker pull kadirsungurlu/bekci:latest
docker stop bekci && docker rm bekci

Ardından 5. adımdaki docker run komutunu yeniden çalıştırın. Güncellemeyi tek komuta indirmek için Docker Compose kullanmanızı öneririz. Güncellemeden önce yedek almayı unutmayın: Güncelleme, yedek ve geri dönüş.

Sık karşılaşılan sorunlar#

“port is already allocated” ya da “address already in use”#

8080 portunu başka bir program kullanıyor. Başka bir konteynerse hangisi olduğunu docker ps --filter publish=8080 gösterir. Coolify kurulu sunucularda Coolify'ın vekili de 8080 portunu kullanır. Başka bir port seçin, ör. -p 8081:8080, ve paneli http://SUNUCU-IP:8081 adresinden açın. Coolify kullanıyorsanız Coolify rehberi daha uygundur.

Tarayıcı “bağlantı zaman aşımına uğradı” diyor#

8080 portu sağlayıcınızın güvenlik duvarında kapalı olabilir; 4. adıma bakın.

Konteyner sürekli yeniden başlıyor#

docker logs bekci çıktısının son satırlarındaki hata: ile başlayan mesaj nedeni söyler. Çözümler için Sorun giderme.

Kaldırma#

docker stop bekci && docker rm bekci
docker volume rm bekci-data    # DİKKAT: tüm verileri kalıcı olarak siler