mirror of https://github.com/frappe/frappe_docker.git synced 2026-06-24 00:35:10 +00:00

ubden e2730e894e docs: Add Dokploy port configuration guide

Explains:
- How Dokploy manages ports vs docker-compose ports
- Why to use 'expose' instead of 'ports' in Dokploy
- Port conflict resolution
- SSL/HTTPS port flow (443 → 8080 internal)
- Recommended configurations for Dokploy vs manual deployment

This helps users understand why we use expose instead of ports mapping in docker-compose.yml when deploying to Dokploy.

2025-10-14 10:10:58 +03:00

3.1 KiB

Raw Blame History

Dokploy Port Konfigürasyonu

🔧 Port Yönetimi

Dokploy'da port mapping Dokploy UI'dan yapılır, docker-compose.yml'de değil!

✅ Doğru Yaklaşım (Dokploy)

docker-compose.yml:

frontend:
  expose:
    - "8080"  # Internal port (Dokploy yönetir)
  # ports: kullanmayın!

Dokploy UI:

Service → Settings → Ports
Container Port: 8080
External Port: [Dokploy otomatik atar]

❌ Yanlış Yaklaşım

# KULLANMAYIN (Dokploy'da port çakışması yaratır):
ports:
  - "80:8080"
  - "8080:8080"

🌐 Erişim Yöntemleri

Dokploy ile (Önerilen)

Domain ekleyin: erp.yourdomain.com
Port: Dokploy otomatik atar
HTTPS: Enable HTTPS ✅
Erişim: https://erp.yourdomain.com

Manuel Docker Compose

Eğer Dokploy kullanmıyorsanız:

# docker-compose.override.yml oluşturun
services:
  frontend:
    ports:
      - "8080:8080"

docker-compose -f docker-compose.yml -f docker-compose.override.yml up -d

🔒 SSL ile Port Yapısı

Dokploy Proxy Akışı

User Browser
    ↓
HTTPS (443) ← Dokploy Proxy (SSL termination)
    ↓
HTTP (8080) ← Frontend Container (internal)
    ↓
HTTP (8000) ← Backend Container

Not: Container'lar arası tüm trafik HTTP'dir (internal network, güvenli).

🐛 Port Çakışması Hatası

Hata

Bind for 0.0.0.0:80 failed: port is already allocated

Sebep

docker-compose.yml'de ports: "80:8080" tanımlı
Başka bir servis zaten 80 portunu kullanıyor
Dokploy'da port management conflict

Çözüm

docker-compose.yml'de:

# Önceden (HATALI):
ports:
  - "${HTTP_PORT:-8080}:8080"

# Şimdi (DOĞRU):
expose:
  - "8080"

Dokploy UI'da:

Domain ekleyin
Enable HTTPS
Dokploy otomatik port yönetir

📋 Dokploy Deployment Adımları

1. Repository Ekle

Repository: https://github.com/ubden/frappe_docker
Branch: main
Compose: dokploy/docker-compose.yml

2. Environment Variables

SITE_NAME=erp.yourdomain.com
ADMIN_PASSWORD=YourPass123!
DB_PASSWORD=DBPass456!
# HTTP_PORT tanımlamayın (Dokploy yönetir)

3. Domain + SSL

Domain: erp.yourdomain.com
Enable HTTPS: ✅
Force HTTPS: ✅

Port otomatik atanır!

4. Deploy

Deploy → Bekle → Hazır!

Erişim: https://erp.yourdomain.com

✅ Önerilen Konfigürasyon

Dokploy için (Production)

✅ expose: ["8080"] kullan
✅ ports: kullanma
✅ Domain ekle
✅ HTTPS aktif et
✅ Dokploy port'u yönetsin

Manuel için (Development)

✅ ports: ["8080:8080"] kullan
✅ Local'de test et
✅ HTTP ile erişim

🔍 Port Kontrolü

Container içinden

# Frontend container'a girin
docker exec -it <frontend> bash

# Nginx'in dinlediği portu kontrol edin
netstat -tuln | grep 8080
# 0.0.0.0:8080 olmalı

Dışarıdan

# Dokploy'da domain varsa
curl https://erp.yourdomain.com

# Yoksa (geliştirme)
curl http://localhost:8080

Dokploy: expose kullan, port yönetimini Dokploy'a bırak
Manuel: ports kullan, manuel yönet
SSL: Dokploy otomatik (443 → 8080 internal)

3.1 KiB Raw Blame History Unescape Escape