...
Eroare Docker · Dockerfile și docker build

no space left on device

Pe scurt

Discul pe care Docker își ține datele (/var/lib/docker sau discul virtual al Docker Desktop) e plin. Vezi ce ocupă spațiul cu docker system df, apoi șterge containerele oprite, imaginile nefolosite și cache-ul de build: docker container prune, docker image prune, docker builder prune.

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

Ce înseamnă

Mesajul vine de la sistemul de fișiere, nu de la Docker, și apare la finalul unei operații care scria pe disc: failed to register layer: … no space left on device la pull, write /var/lib/docker/…: no space left on device la build, sau din aplicația din container, când scrie un fișier.

Docker adună multe lucruri pe disc fără să le șteargă singur: fiecare build lasă straturi în cache, fiecare versiune nouă a unei imagini cu același tag lasă în urmă vechea imagine ca <none> (dangling), containerele oprite își păstrează straturile de scriere, iar volumele rămân după ștergerea containerelor. docker system df arată exact cât ocupă fiecare categorie și cât poate fi eliberat (coloana RECLAIMABLE).

Pe Docker Desktop, limita e mărimea discului virtual (setată în Settings > Resources), deci eroarea poate apărea chiar dacă discul calculatorului are loc.

De ce apare: cauzele frecvente

1Imagini vechi și dangling adunate

Greșit
BASH
docker build -t api:latest .   # de 50 de ori
Corect
BASH
docker image prune -f
docker image prune -a -f   # și imaginile nefolosite de niciun container

Fiecare build cu același tag lasă imaginea veche fără nume. prune le șterge pe cele care nu mai sunt folosite.

2Cache de build mare

Greșit
BASH
docker system df
# Build Cache ... 12GB
Corect
BASH
docker builder prune -f
# sau doar ce e mai vechi de o săptămână:
docker builder prune -f --filter until=168h

BuildKit păstrează straturile intermediare ca să grăbească build-urile, iar cache-ul crește nelimitat dacă nu-l cureți.

3Containere oprite și volume uitate

Greșit
BASH
docker ps -a | wc -l   # sute de containere oprite
Corect
BASH
docker container prune -f
docker volume ls -f dangling=true
docker volume prune -f   # doar după ce verifici lista

Containerele oprite și volumele fără container ocupă spațiu. Volumele pot avea date importante, deci le verifici înainte de prune.

Repară tu

Repară eroarea, direct în pagină

Build-urile au început să eșueze cu no space left on device. Afișează cât ocupă fiecare categorie cu docker system df, apoi eliberează spațiu: șterge containerele oprite, imaginile fără tag rămase după build-uri și cache-ul de build. Volumul date-magazin conține date importante și trebuie să rămână.

Indiciu

Fiecare categorie are propriul prune (container, image, builder), iar -f sare peste confirmare; nu folosi --volumes.

Alte forme ale mesajului

  • failed to register layer: write /usr/lib/x86_64-linux-gnu/libLLVM.so.15: no space left on device
  • ERROR: failed to solve: failed to copy files: copy file range failed: no space left on device
  • Error response from daemon: mkdir /var/lib/docker/overlay2/3f2a.../merged: no space left on device

Cum o eviți pe viitor

  • Verifică periodic docker system df și curăță cu docker system prune (fără --volumes, ca să nu pierzi date).
  • Folosește --rm la containerele temporare și .dockerignore ca să nu trimiți în context node_modules, loguri sau arhive.
  • Folosește imagini mici (-slim, -alpine) și build-uri multi-stage.
  • Pe servere, programează curățenia cache-ului (docker builder prune --filter until=168h) și monitorizează spațiul liber.

Întrebări frecvente

docker system prune îmi șterge datele?

Fără --volumes, nu: șterge containerele oprite, rețelele nefolosite, imaginile dangling și cache-ul de build. Cu -a șterge și imaginile nefolosite (le descarci din nou la nevoie). Volumele se șterg doar cu --volumes, deci adaugă opțiunea numai când știi ce conțin.

Am șters tot și tot nu am loc. Ce mai poate fi?

Jurnalele containerelor (fișierele *-json.log din /var/lib/docker/containers pot crește mult; limitează-le cu --log-opt max-size=10m), volumele mari sau, pe Docker Desktop, discul virtual care trebuie mărit din setări.

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.