Se qBittorrent riesce a vedere una cartella in ZimaOS, ma ogni torrent fallisce immediatamente, cambiare solo il percorso di download all'interno di qBittorrent non è sufficiente. Prima è necessario montare la cartella dell'host nel container Docker e l'utente che esegue qBittorrent all'interno del container deve avere il permesso di scrivere nella directory montata dell'host.
È quanto è accaduto nella discussione della IceWhale Community di gennaio 2026. L'autore originale aveva mappato una cartella multimediale in /Movies-TV, ma il registro di esecuzione di qBittorrent mostrava Permission denied. Una sottocartella dedicata e permessi di scrittura sull'host hanno risolto il problema originale. La community ha usato chmod -R 777 come soluzione rapida, ma le indicazioni attuali di LinuxServer preferiscono allineare PUID/PGID alla proprietà dell'host invece di lasciare la directory scrivibile da chiunque.
Percorso dell'host e percorso del container
Un percorso ZimaOS non è automaticamente visibile all'interno di qBittorrent. Una mappatura tipica è:
Host: /DATA/Downloads
Container: /downloadsIn questo caso qBittorrent dovrebbe salvare in un percorso del container come /downloads/qbittorrent.
La mappatura originale
Host: /media/Main Storage/Media/Movies
Container: /Movies-TV
Crea una cartella di download dedicata
La struttura funzionante usata dalla community era:
/media/Main Storage/Media/Movies/qbittorrent-downloadse all'interno di qBittorrent veniva usato questo percorso:
/Movies-TV/qbittorrent-downloadsControlla i permessi
ls -ld "/media/Main Storage/Media/Movies"
ls -ld "/media/Main Storage/Media/Movies/qbittorrent-downloads"Se la directory esiste, ma il registro mostra Permission denied, l'identità del container non dispone dell'accesso in scrittura.
La soluzione rapida confermata dalla community
chmod -R 777 "/media/Main Storage/Media/Movies/qbittorrent-downloads"L'autore originale ha confermato che questa soluzione ha funzionato. Tuttavia, 777 concede in modo esteso i permessi di lettura, scrittura ed esecuzione, quindi è meglio usarlo come strumento diagnostico o soluzione temporanea, non come modello ideale di autorizzazione permanente.
Soluzione a lungo termine consigliata: allinea PUID e PGID
L'immagine qBittorrent attuale di LinuxServer supporta PUID e PGID proprio per evitare conflitti di autorizzazione con i bind mount. La documentazione consiglia di rendere la proprietà della directory dell'host compatibile con gli ID forniti al container.
Documentazione LinuxServer qBittorrent
PUID=1000
PGID=1000Questi valori sono solo esempi. Controlla l'account host desiderato con id USERNAME e usa gli ID effettivi oppure un gruppo condiviso compatibile.
Riavvia e verifica
- Salva la mappatura del volume.
- Riavvia o ricrea qBittorrent.
- Imposta il percorso di salvataggio predefinito sul percorso mappato del container.
- Avvia un piccolo download di prova.
- Se il problema persiste, consulta Strumenti → Registro di esecuzione.
Significato degli errori
- Permission denied: il percorso esiste, ma non è scrivibile.
- No such file or directory: il percorso del container è assente o mappato in modo errato.
Domande frequenti sul percorso di download di qBittorrent
qBittorrent deve usare il percorso dell'host ZimaOS?
No. Normalmente deve usare il percorso del container definito nella mappatura del volume.
chmod 777 ha risolto il problema della discussione originale?
Sì. L'autore ha confermato che ha funzionato, ma a lungo termine sono più sicuri permessi più restrittivi basati su PUID/PGID o sui gruppi.
Perché qBittorrent riesce a vedere una cartella, ma non a scriverci?
La visibilità del mount Docker e i permessi di scrittura del file system sono aspetti distinti. Una cartella mappata può essere leggibile, ma non scrivibile dall'utente del container.
