...
Eroare Docker · Pornirea și gestionarea containerelor

docker: Error response from daemon: driver failed programming external connectivity on endpoint magazin: Bind for 0.0.0.0:8080 failed: port is already allocated.

Pe scurt

Portul de pe calculator din -p 8080:80 e deja folosit de alt container (sau de alt program). Găsește-l cu docker ps --filter publish=8080, oprește-l, sau publică pe alt port, de exemplu -p 8081:80.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

La -p 8080:80, primul număr e portul de pe calculator, al doilea portul din container. Pe calculator, un port poate fi ascultat de un singur proces, deci dacă 8080 e deja luat, Docker nu-l mai poate lega pentru containerul nou.

Mesajul se citește de la coadă: Bind for 0.0.0.0:8080 failed: port is already allocated e motivul, iar endpoint magazin e containerul tău nou. Atenție: containerul a fost creat totuși, în starea Created, deci după ce eliberezi portul îl poți porni cu docker start magazin (sau trebuie să-l ștergi înainte să refolosești numele).

Cel mai des, portul e ocupat de un container vechi al tău, pornit ieri sau din alt proiect compose. Varianta address already in use înseamnă de obicei că portul e ținut de un program din afara Docker (un server local, alt nginx, un npm run dev).

De ce apare: cauzele frecvente

1Un container vechi ține portul

Greșit
BASH
docker run -d --name magazin -p 8080:80 magazin-web:1.0
Corect
BASH
docker ps --filter publish=8080
docker stop site-vechi && docker rm site-vechi
docker start magazin

Containerul vechi publică deja 8080. După ce îl oprești, portul e liber, iar containerul nou (rămas Created) poate porni.

2Vrei ambele containere pornite

Greșit
BASH
docker run -d --name test -p 8080:80 magazin-web:1.0
Corect
BASH
docker run -d --name test -p 8081:80 magazin-web:1.0

Portul din container (80) poate fi același; doar portul de pe calculator trebuie să fie diferit pentru fiecare container.

3Un program din afara Docker folosește portul

Greșit
BASH
docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=x postgres:16
# Postgres e instalat și pe calculator
Corect
BASH
sudo ss -tlnp | grep 5432
docker run -d -p 5433:5432 -e POSTGRES_PASSWORD=x postgres:16

Un Postgres local ascultă deja pe 5432. Fie îl oprești, fie publici containerul pe alt port și te conectezi la 5433.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin ai construit imaginea magazin-web:1.0, dar docker run -d --name magazin -p 8080:80 magazin-web:1.0 dă port is already allocated. Află ce container ocupă portul 8080, oprește-l și șterge-l, apoi pornește containerul magazin pe portul 8080 (comanda eșuată l-a creat deja, în starea Created).

Indiciu

docker ps --filter publish=8080 arată cine ține portul; după ce îl eliberezi, docker start magazin pornește containerul deja creat.

Alte forme ale mesajului

  • Error response from daemon: driver failed programming external connectivity on endpoint web-1: Bind for 0.0.0.0:80 failed: port is already allocated
  • Error starting userland proxy: listen tcp4 0.0.0.0:5432: bind: address already in use
  • Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:8080 -> 0.0.0.0:0: listen tcp 0.0.0.0:8080: bind: address already in use

Cum o eviți pe viitor

  • Dă containerelor nume (--name) ca să știi ce rulează și oprește-le la finalul lucrului (docker stop, docker compose down).
  • Ține o mică listă de porturi pe proiect (8080 site, 3000 API, 5433 baza de test) și scrie-le în compose.yaml.
  • Înainte de docker run -p, verifică portul: docker ps --filter publish=8080 sau ss -tlnp.
  • Pentru teste rapide, -p 127.0.0.1::80 lasă Docker să aleagă un port liber (îl afli cu docker port).

Întrebări frecvente

Am oprit containerul vechi, de ce docker run dă acum eroare de nume?

Pentru că prima încercare a creat deja containerul magazin, în starea Created. Pornește-l cu docker start magazin sau șterge-l cu docker rm magazin înainte să rulezi din nou docker run --name magazin.

Pot avea două containere pe același port din container?

Da. Portul din container (cel din dreapta) e al fiecărui container, izolat. Conflictul apare doar pe portul de pe calculator, cel din stânga.

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.