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

sh: can't create /usr/share/nginx/html/nou.html: Read-only file system

Pe scurt

Folderul în care scrii e montat doar pentru citire: un bind mount sau volum cu :ro, --mount ...,readonly sau un container pornit cu --read-only. Scrie fișierul pe calculator, în folderul montat (modificarea apare imediat în container), sau montează fără :ro dacă scrierea din container chiar e necesară.

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

Ce înseamnă

Mesajul vine de la sistemul de operare din container: scrierea a fost refuzată nu din cauza permisiunilor utilizatorului (asta ar fi Permission denied), ci pentru că tot sistemul de fișiere de la acea cale e montat doar pentru citire. Nici root nu poate scrie acolo.

În Docker, asta apare în trei situații: ai montat un folder cu -v sursa:destinatie:ro (sau readonly la --mount), containerul rulează cu --read-only (tot sistemul de fișiere al containerului e doar citire, mai puțin volumele și --tmpfs), ori folosești un volum montat :ro în compose.yaml.

De obicei montarea doar pentru citire e intenționată, pentru siguranță: serverul web nu are de ce să-și modifice fișierele. Atunci reparația corectă nu e să scoți :ro, ci să modifici fișierele la sursă (pe calculator) sau să dai aplicației un loc separat, scriibil, pentru datele ei (un volum sau --tmpfs /tmp).

De ce apare: cauzele frecvente

1Scrii într-un bind mount montat :ro

Greșit
BASH
docker run -d -v ~/site:/usr/share/nginx/html:ro nginx
docker exec web sh -c 'echo nou > /usr/share/nginx/html/nou.html'
Corect
BASH
echo '<p>nou</p>' > ~/site/nou.html
curl -s localhost:8080/nou.html

Folderul e același pe calculator și în container. Scrii pe calculator, unde nu e restricționat, iar nginx vede fișierul imediat.

2Container pornit cu --read-only fără loc pentru fișiere temporare

Greșit
BASH
docker run -d --read-only magazin-api:1.0
# EROFS: read-only file system, open '/tmp/sesiune'
Corect
BASH
docker run -d --read-only --tmpfs /tmp magazin-api:1.0

--tmpfs montează un folder în memorie, scriibil, doar pentru calea de care aplicația are nevoie.

3Aplicația chiar trebuie să scrie în folder

Greșit
BASH
docker run -d -v ~/incarcari:/app/uploads:ro magazin-api:1.0
Corect
BASH
docker run -d -v ~/incarcari:/app/uploads magazin-api:1.0

Dacă folderul e pentru încărcări sau date ale aplicației, nu-l monta :ro.

Repară tu

Repară eroarea, direct în pagină

Serverul site servește folderul ~/site montat doar pentru citire (:ro) în nginx, pe portul 8080. Încercarea de a adăuga pagina promotii.html din container a dat Read-only file system. Păstrează montarea :ro și publică totuși pagina promotii.html cu textul Reduceri de iarnă, astfel încât curl localhost:8080/promotii.html s-o afișeze.

Indiciu

Un bind mount e același folder pe calculator și în container: scrie fișierul în ~/site.

Alte forme ale mesajului

  • touch: /date/a.txt: Read-only file system
  • Error: EROFS: read-only file system, open '/app/logs/app.log'
  • OSError: [Errno 30] Read-only file system: '/app/cache'

Cum o eviți pe viitor

Separă clar ce e cod sau configurare (montat :ro sau copiat în imagine) de ce sunt date scrise de aplicație (volume dedicate, scriibile). Când pornești containere cu --read-only pentru siguranță, adaugă de la început --tmpfs /tmp și volume pentru folderele de date. docker inspect -f '{{json .Mounts}}' nume îți arată ce e montat și cu ce mod ("RW": false înseamnă doar citire).

Întrebări frecvente

E la fel cu Permission denied?

Nu. Permission denied înseamnă că utilizatorul din container n-are drepturi pe fișier, deși sistemul de fișiere e scriibil (se rezolvă cu chown/USER/-u). Read-only file system înseamnă că nimeni nu poate scrie la acea cale, nici root.

Pot scoate :ro dintr-un container care rulează?

Nu, montările se stabilesc la crearea containerului. Ca să schimbi modul, recreezi containerul cu altă opțiune -v.

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.