Docker Engine

dockerd-rootless.sh: XDG_RUNTIME_DIR is not set. Rootless docker cannot start. – Docker DOCKERD_ROOTLESS_XDG

DOCKERD_ROOTLESS_XDG

La modalità Docker Rootless richiede che la variabile d'ambiente `XDG_RUNTIME_DIR` punti a una directory `/run/user/<UID>` montata come tmpfs e gestita da systemd/logind.

Categoria: DockerGruppo: Docker EngineConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

La modalità Docker Rootless richiede che la variabile d'ambiente `XDG_RUNTIME_DIR` punti a una directory `/run/user/<UID>` montata come tmpfs e gestita da systemd/logind.

Messaggio originale

dockerd-rootless.sh: XDG_RUNTIME_DIR is not set. Rootless docker cannot start.

Contesto e parole chiave

Alias

  • docker rootless error
  • XDG_RUNTIME_DIR is not set

Messaggi alternativi

  • variabile XDG_RUNTIME_DIR non impostata docker rootless fallito

Prodotti

  • Docker Engine / Docker Compose / BuildKit / containerd

Piattaforme

  • Docker Desktop su macOS
  • Docker Desktop su Windows
  • Linux

Parole chiave

  • compose
  • container
  • docker
  • Docker Engine
  • docker.engine.dockerd-rootless-xdg-runtime-missing
  • DOCKERD_ROOTLESS_XDG
  • errore-docker-rootless-xdg-runtime-dir-unset

Cause possibili

Origine del problema per Docker Engine Rootless: variabile XDG_RUNTIME_DIR non definita

La modalità Docker Rootless richiede che la variabile d'ambiente `XDG_RUNTIME_DIR` punti a una directory `/run/user/<UID>` montata come tmpfs e gestita da systemd/logind.

molto comune

Diagnosi

Diagnostica container e log per Docker Engine Rootless: variabile XDG_RUNTIME_DIR non definita

Eseguire comandi di ispezione dei container e controllare i log del demone Docker con journalctl o docker logs.

Come leggere il risultato. Mostra le eccezioni a runtime dell'applicazione, segnali di terminazione o errori di rete interna.

docker
docker logs --tail 50 <container_id>

Risoluzione

Procedura di risoluzione per Docker Engine Rootless: variabile XDG_RUNTIME_DIR non definita

Difficoltà: mediaRischio: basso

Applicare la configurazione raccomandata nelle specifiche ufficiali Docker e BuildKit.

  1. Ispezionare i parametri di avvio nel file Dockerfile o docker-compose.yml
  2. Verificare i vincoli di memoria, permessi e compatibilità delle porte
  3. Riavviare il container o eseguire una compilazione pulita senza cache

Domande frequenti

Come risolvere il problema DOCKERD_ROOTLESS_XDG in Docker?

La modalità Docker Rootless richiede che la variabile d'ambiente `XDG_RUNTIME_DIR` punti a una directory `/run/user/<UID>` montata come tmpfs e gestita da systemd/logind.

Approfondimenti

Schede correlate