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

docker: Error response from daemon: network magazin-net not found.

Pe scurt

Rețeaua dată la --network nu există pe acest daemon: n-a fost creată încă, are alt nume sau a fost ștearsă. Creeaz-o cu docker network create magazin-net (sau verifică numele cu docker network ls), apoi pornește containerul.

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

Ce înseamnă

Rețelele Docker proprii nu apar singure: le creezi cu docker network create, iar Docker Compose le creează pentru proiect, cu numele prefixat (magazin_default, magazin_front). docker run --network nume doar leagă containerul de o rețea existentă, nu o creează.

Mesajul apare la docker run, docker network connect sau docker network inspect, și ai de verificat două lucruri: dacă rețeaua există (docker network ls) și dacă numele e scris exact. Cea mai frecventă capcană e Compose: în compose.yaml rețeaua se numește backend, dar pe daemon numele real e proiect_backend, deci un container pornit separat cu --network backend nu o găsește.

După docker network prune sau docker compose down, rețelele proiectului sunt șterse; containerele create înainte și legate de ele dau la pornire o eroare asemănătoare, pentru că rețeaua lor nu mai există.

De ce apare: cauzele frecvente

1Rețeaua n-a fost creată

Greșit
BASH
docker run -d --name api --network magazin-net nginx:1.27-alpine
Corect
BASH
docker network create magazin-net
docker run -d --name api --network magazin-net nginx:1.27-alpine

--network leagă containerul de o rețea existentă. Cu network create, rețeaua există înainte de pornire.

2Numele rețelei din Compose are prefixul proiectului

Greșit
BASH
docker run --rm --network backend alpine ping -c1 db
Corect
BASH
docker network ls
docker run --rm --network magazin_backend alpine ping -c1 db

Compose numește rețelele proiect_nume. În afara proiectului folosești numele complet.

3Rețeaua a fost ștearsă de compose down

Greșit
BASH
docker compose down
docker start unelte   # era legat de magazin_default
Corect
BASH
docker compose up -d
docker network connect magazin_default unelte

down șterge rețeaua proiectului. După up, rețeaua e recreată și poți lega din nou containerul extern.

Repară tu

Repară eroarea, direct în pagină

Comanda docker run -d --name api --network magazin-net nginx:1.27-alpine dă network magazin-net not found. Creează rețeaua magazin-net și pornește containerul api legat de ea, apoi verifică cu docker network inspect că api apare în rețea.

Indiciu

Rețelele proprii se creează cu docker network create.

Alte forme ale mesajului

  • Error response from daemon: network magazin-net not found
  • Error response from daemon: failed to set up container networking: network 3f2a1b4c5d6e... not found
  • network backend declared as external, but could not be found

Cum o eviți pe viitor

Pune containerele care trebuie să comunice în același fișier compose.yaml: Compose creează rețeaua și o leagă singur de servicii. Când chiar ai nevoie de o rețea comună între proiecte, creeaz-o o dată, explicit (docker network create comuna), și declar-o în compose.yaml ca external: true, cu numele exact. Verifică cu docker network ls înainte de --network.

Întrebări frecvente

Pot crea rețeaua automat la docker run?

Nu, docker run nu creează rețele. Fie rulezi docker network create înainte, fie lași Docker Compose să le creeze pentru proiect.

Ce înseamnă „declared as external, but could not be found”?

În compose.yaml rețeaua are external: true, deci Compose nu o creează, ci se așteaptă să existe deja. Creeaz-o cu docker network create nume sau scoate external.

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.