Docker Compose Network Hataları: 5 Yaygın Sorun ve Çözümleri (2025)

Hata Mesajı / Error Message:

ERROR: network my_network id xxx has active endpoints
Error response from daemon: error while removing network:
network my_network has active endpoints

# Önce tüm container'ları durdur (Stop all containers)
docker-compose down

# Eğer hata devam ederse (If error persists):
docker-compose down --remove-orphans

# Nuclear option (tüm container'ları sil):
docker stop $(docker ps -aq)
docker rm $(docker ps -aq)

Alesta Web İpucu: Bu komut tüm container'ları temizler (cleans all containers)!

# Network'e bağlı container'ları bul (Find connected containers)
docker network inspect my_network

# Container'ları durdur ve network'ü sil:
docker network rm my_network

# Eğer "has active endpoints" hatası alırsanız:
docker network disconnect -f my_network container_name
docker network rm my_network

# Container ve network'leri yeniden oluştur (Recreate):
docker-compose up --force-recreate

# Daha agresif (More aggressive):
docker-compose up --force-recreate --remove-orphans

Bu, alestaweb.com olarak en çok önerdiğimiz yöntem (our most recommended method)!

Hata Mesajı / Error Message:

ERROR: Network my_app_default declared as external, but could not be found
network my_network not found

# Network'ü oluştur (Create network):
docker network create my_network

# Sonra compose'u çalıştır:
docker-compose up

❌ Yanlış (Wrong):

networks:
  my_network:
    external: true  # Network yoksa hata!

✅ Doğru (Correct):

networks:
  my_network:
    driver: bridge  # Docker otomatik oluşturacak

Alesta Web deneyimi: external: true sadece network zaten varsa kullan!

docker-compose up --force-recreate

Docker network'leri otomatik yeniden oluşturur (automatically recreates networks).

Hata Mesajı / Error Message:

curl: (6) Could not resolve host: my-service
Connection refused to my-service:8080
getaddrinfo ENOTFOUND my-service

❌ Yanlış (Wrong):

# Container içinde
curl http://localhost:8080  # ÇALIŞMAZ!

✅ Doğru (Correct):

# docker-compose.yml'deki service ismini kullan
curl http://my-service:8080  # ÇALIŞIR!

Alesta Web İpucu: Container'lar arası iletişimde service name kullanın, localhost değil! (use service name, not localhost!)

docker-compose.yml Örneği:

version: '3.8'

services:
  web:
    image: nginx
    networks:
      - my_network  # Aynı network

  api:
    image: node:20
    networks:
      - my_network  # Aynı network

  db:
    image: postgres
    networks:
      - my_network  # Aynı network

networks:
  my_network:
    driver: bridge

Tüm servisler aynı network'te olmalı (all services must be on the same network)!

# Hangi container hangi network'te?
docker network inspect my_app_default

# Container içinden test et:
docker exec -it container_name ping my-service

Hata Mesajı / Error Message:

ERROR: for web  Cannot start service web:
driver failed programming external connectivity:
Bind for 0.0.0.0:8080 failed: port is already allocated

Linux/Mac:

lsof -i :8080
# Veya (or):
netstat -tulpn | grep 8080

Windows:

netstat -ano | findstr :8080

Process'i durdur veya farklı port kullan (stop the process or use different port).

docker-compose.yml'de Port Değiştir:

services:
  web:
    image: nginx
    ports:
      - "8081:80"  # 8080 yerine 8081 kullan (use 8081 instead of 8080)

services:
  web:
    image: nginx
    expose:
      - "80"  # Sadece container'lar arası (only between containers)
    # ports yok! (no ports exposed to host)

alestaweb.com tavsiyesi: Backend servislerde host port'a gerek yok!

Hata Mesajı / Error Message:

Got permission denied while trying to connect to the Docker daemon socket
Permission denied connecting to /var/run/docker.sock

# Kullanıcıyı docker grubuna ekle:
sudo usermod -aG docker $USER

# Logout/login yap veya:
newgrp docker

# Test et:
docker ps

Alesta Web önerisi: Bu kalıcı çözüm (permanent solution)!

sudo docker-compose up

⚠️ Geçici çözüm, her seferinde sudo gerekecek (temporary, needs sudo every time).

version: '3.8'

services:
  web:
    networks:
      - frontend
  api:
    networks:
      - frontend
      - backend
  db:
    networks:
      - backend

networks:
  frontend:
    driver: bridge
  backend:
    driver: bridge

Servisleri mantıksal olarak ayır (separate services logically)!

# Compose dosyanızın son halini görün:
docker-compose config

# Network ayarlarını kontrol edin

alestaweb.com ipucu: Bu komut "gold"! Tüm varsayılan ayarları gösterir (shows all default settings).

# Kullanılmayan network'leri sil (Remove unused networks):
docker network prune

# Kullanılmayan tüm kaynakları sil (Remove all unused resources):
docker system prune

# Agresif temizlik (Aggressive cleanup):
docker system prune -a --volumes

# Container loglarını izle (Watch container logs):
docker-compose logs -f

# Specific service:
docker-compose logs -f web

# Network detaylarını incele (Inspect network details):
docker network inspect myapp_default