...
Eroare Docker · Rețele, porturi și volume

Error response from daemon: network with name magazin-net already exists

Pe scurt

Încerci să creezi o rețea care există deja, de obicei într-un script rulat a doua oară. Nu e nevoie să o creezi din nou: folosește-o direct cu --network magazin-net, sau creeaz-o doar dacă lipsește: docker network inspect magazin-net >/dev/null 2>&1 || docker network create magazin-net.

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

Ce înseamnă

Numele rețelelor sunt unice pe un daemon: docker network create magazin-net merge prima dată și dă această eroare la orice încercare următoare. Rețeaua existentă rămâne neatinsă, cu containerele ei.

Se întâmplă aproape mereu în scripturi de pornire sau în pașii unui pipeline care rulează network create la fiecare execuție. Scriptul se oprește la primul pas (mai ales cu set -e), deși rețeaua e exact cea de care are nevoie.

Ai trei variante, după situație: o folosești direct (nu o mai creezi); o creezi condiționat, doar dacă docker network inspect eșuează; sau, dacă vrei o rețea curată, o ștergi și o recreezi (după ce deconectezi containerele). Docker Compose face singur verificarea pentru rețelele proiectului.

De ce apare: cauzele frecvente

1Script rulat a doua oară

Greșit
BASH
docker network create magazin-net
docker run -d --name api --network magazin-net api:1.0
Corect
BASH
docker network inspect magazin-net > /dev/null 2>&1 || docker network create magazin-net
docker run -d --name api --network magazin-net api:1.0

inspect reușește dacă rețeaua există, iar create rulează doar când lipsește.

2Rețeaua creată de alt proiect

Greșit
BASH
docker network create comuna
# a creat-o deja proiectul vecin
Corect
BASH
docker network ls --filter name=comuna
docker run -d --name raport --network comuna raport:1.0

Dacă rețeaua comună există, doar te legi de ea.

3Rețea externă în Compose creată la fiecare deploy

Greșit
BASH
docker network create proxy && docker compose up -d
Corect
BASH
networks:
  proxy:
    external: true

Rețeaua externă se creează o singură dată, manual; compose doar o folosește.

Repară tu

Repară eroarea, direct în pagină

Scriptul de pornire rulează docker network create magazin-net și apoi pornește API-ul. A doua oară, se oprește cu network with name magazin-net already exists, iar containerul api nu mai pornește. Pornește containerul api (din nginx:1.27-alpine) pe rețeaua existentă, cu o comandă de creare a rețelei care nu mai dă eroare dacă rețeaua există.

Indiciu

docker network inspect magazin-net > /dev/null 2>&1 || docker network create magazin-net.

Alte forme ale mesajului

  • Error response from daemon: network with name comuna already exists
  • network with name magazin-net already exists

Cum o eviți pe viitor

Scrie scripturile de pornire idempotent: fiecare pas verifică dacă ce creează există deja (docker network inspect, docker volume inspect, docker ps -a --filter name=). Și mai simplu, lasă Docker Compose să gestioneze rețelele: le creează doar dacă lipsesc și le șterge la down.

Întrebări frecvente

Pot avea două rețele cu același nume?

Pe un daemon local, nu. Fiecare rețea are și un ID, iar comenzile acceptă oricare dintre ele, dar numele trebuie să fie unic.

Ce se întâmplă cu containerele dacă recreez rețeaua?

Nu poți șterge o rețea cu containere conectate (has active endpoints). Le deconectezi sau le ștergi întâi; după ce o recreezi, le conectezi din nou cu docker network connect.

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.