Soluzione della community

Perché apt non è disponibile su ZimaOS: Buildroot, file di sistema di sola lettura e app Docker

An October 2024 beginner thread where apt commands failed even from root/ttydBridge. The community correctly explained that ZimaOS is an appliance OS rather than Ubuntu/Debian and does not support installing host packages with apt. Current official documentation now explicitly describes ZimaOS as Buildroot-based, mostly read-only, and container-oriented.

apt: comando non trovato su ZimaOS non significa che sudo non funzioni. Significa che ZimaOS non è Ubuntu né Debian e non include il flusso di gestione dei pacchetti APT utilizzato da queste distribuzioni. L’utente della fonte di ottobre 2024 aveva effettuato l’accesso come root e tramite ttydBridge, ma non riusciva comunque ad aggiornare o installare pacchetti sull’host perché ZimaOS non è progettato in questo modo.

La documentazione attuale di IceWhale chiarisce meglio l’architettura: ZimaOS è basato su Buildroot, la maggior parte delle cartelle di sistema è di sola lettura anche per root e le applicazioni devono essere eseguite tramite container anziché essere installate nel sistema operativo host con apt, yum o strumenti simili.

Il problema non era sudo

L’utente originale pensava che i “comandi sudo” non funzionassero perché comandi come sudo apt ... restituivano errori di comando non trovato.

sudo modifica solo il contesto dei privilegi. Non può creare un gestore di pacchetti che non è installato nel sistema operativo.

ZimaOS è basato su Buildroot

Le guide attuali di IceWhale descrivono ZimaOS come un sistema Buildroot in stile appliance. Buildroot produce un’immagine Linux compatta per sistemi embedded, non una distribuzione generica con un database dei pacchetti modificabile e normali repository APT.

Per questo, provare a seguire tutorial sulla gestione dei pacchetti Debian/Ubuntu sull’host ZimaOS spesso non funziona, anche se sono disponibili molti comandi Linux familiari.

La maggior parte delle directory di sistema è intenzionalmente di sola lettura

Le indicazioni attuali della CLI di ZimaOS specificano che la maggior parte delle cartelle di sistema rimane di sola lettura anche quando l’utente accede come root. I dati utente e delle applicazioni scrivibili devono trovarsi in /DATA.

Consulta il modello attuale del filesystem CLI di ZimaOS prima di provare a modificare il sistema operativo di base.

Usa Docker per le applicazioni server

Se un tutorial dice di “installare questo demone con apt”, verifica prima se la stessa applicazione dispone di un’immagine Docker o di uno stack Compose mantenuto. Questo è il modello nativo delle applicazioni ZimaOS e mantiene le dipendenze separate dall’host immutabile.

Questo vale per server multimediali, strumenti di monitoraggio, database, client VPN, piattaforme di automazione, servizi per documenti e molte altre applicazioni per homelab.

Usa ZVM quando il software richiede realmente un host Debian/Ubuntu completo

Alcune applicazioni richiedono systemd, un gestore di pacchetti, moduli del kernel o diversi servizi a livello di sistema operativo. In questo caso, una macchina virtuale Debian o Ubuntu è più adatta che cercare di costringere l’host ZimaOS a comportarsi come una di queste distribuzioni.

All’interno della macchina virtuale, la normale gestione dei pacchetti con apt funziona perché il sistema operativo guest è effettivamente Debian/Ubuntu.

SSH e ttydBridge hanno comunque una loro utilità

Il fatto che l’installazione dei pacchetti non sia supportata non rende inutile la riga di comando. SSH e il terminale web restano utili per ispezioni, log, comandi Docker, operazioni sui file nello spazio di archiviazione scrivibile e risoluzione avanzata dei problemi.

Le indicazioni attuali di IceWhale supportano sia SSH sia un terminale nel browser tramite la Modalità sviluppatore.

Il problema dell’utente della fonte con Jellyfin non era correlato ad apt

L’autore originale aveva poi indicato che alcuni video venivano riprodotti in Files ma non in Jellyfin. Le risposte di IceWhale e della community lo hanno indirizzato alla configurazione dei percorsi multimediali in Docker.

Questa è la distinzione corretta: un problema di riproduzione o di libreria in Jellyfin deve essere analizzato tramite le mappature dei volumi dell’applicazione, i codec, la transcodifica e i log, non installando pacchetti casuali sull’host con APT.

Domande frequenti su apt in ZimaOS

Posso installare apt sull’host ZimaOS?

ZimaOS non è progettato per la gestione dei pacchetti tramite APT; usa invece container o una macchina virtuale, senza trattare l’host come se fosse Debian.

L’accesso root rende scrivibili le cartelle di sistema?

No. ZimaOS mantiene intenzionalmente la maggior parte delle cartelle di sistema in sola lettura anche per root.

Dove devono essere archiviati gli script personalizzati e i file scrivibili?

Usa una posizione scrivibile sotto /DATA o un altro percorso di archiviazione dati gestito.