Nuova documentazione Zima: dalla configurazione di ZimaOS alle app, all’hardware, agli strumenti per sviluppatori e alla community

Un home server raramente rimane uguale a com’era il primo giorno. Si inizia portando il sistema online, poi si aggiunge spazio di archiviazione, si trasferiscono i propri file, si installano alcune app, si sperimenta con l’accesso remoto e alla fine ci si ritrova a confrontare i livelli RAID, usare Jellyfin, fare il backup delle foto, testare l’IA locale o leggere di ZFS a tarda sera di domenica.

Ecco perché abbiamo ricostruito la documentazione di ZimaSpace intorno alle attività che le persone cercano davvero di svolgere. Invece di trattare la documentazione come un unico lungo manuale, la nuova struttura offre cinque percorsi di apprendimento chiari: ZimaOS, App Store, Hardware, Sviluppatori e Centro assistenza. E quando il percorso documentato non basta, la Community di ZimaSpace offre un altro spazio in cui confrontare le configurazioni, fare domande, condividere soluzioni e scoprire cosa stanno creando gli altri utenti.

Per la maggior parte dei nuovi utenti, il percorso inizia naturalmente con ZimaOS, passa alle app una volta configurate le basi e si dirama verso hardware o strumenti per sviluppatori man mano che la configurazione diventa più ambiziosa. Tuttavia, non esiste un ordine obbligatorio: se sei qui per Jellyfin, vai direttamente all’App Store; se ti servono ZFS o SSH, vai direttamente alla sezione Sviluppatori; se qualcosa ha già smesso di funzionare, inizia dal Centro assistenza; e se la tua configurazione non corrisponde esattamente a una guida ufficiale, la Community è spesso il posto successivo da consultare.

1. ZimaOS: inizia dalle fondamenta

La documentazione di ZimaOS è il punto di partenza migliore se la tua domanda principale riguarda il corretto funzionamento del sistema operativo, dello spazio di archiviazione, dei dati, dei backup e dell'accesso quotidiano.

Questa parte della documentazione segue il normale ciclo di vita di un server domestico invece di trattare ogni funzionalità come un tutorial isolato: avviare il sistema, organizzare lo spazio di archiviazione, trasferire i dati, renderli accessibili e imparare a mantenere il server.

Panoramica

La panoramica di ZimaOS funge da punto di accesso all'intera sezione. Se non sai ancora quale guida ti serve, inizia da qui. Collega configurazione, spazio di archiviazione, backup, condivisione dei file, installazione e gestione del sistema, così puoi passare rapidamente al problema che stai realmente cercando di risolvere.

Per un sistema completamente nuovo, la guida Inizia a usare ZimaOS è il percorso più diretto. Illustra la prima connessione, ZimaClient, la creazione dell'account e l'ambiente di base che utilizzerai in seguito.

Configurazione e spazio di archiviazione

Se il server è nuovo, dedica un po' di tempo a questa sezione prima di installare dieci app solo perché sembrano interessanti.

Configurazione e spazio di archiviazione riguardano le decisioni che in seguito diventano più difficili da modificare: comprendere l'interfaccia di ZimaOS, scegliere le unità, creare lo spazio di archiviazione, confrontare le opzioni RAID e decidere dove archiviare i dati delle applicazioni.

La guida alla configurazione dello spazio di archiviazione di ZimaOS è particolarmente utile se devi scegliere tra un semplice sistema con un solo disco, uno spazio di archiviazione ridondante per i file importanti, una libreria multimediale più ampia o uno spazio di archiviazione per un server domestico sempre acceso.

Impostare correttamente la struttura dello spazio di archiviazione fin dall'inizio rende quasi tutto ciò che segue più semplice.

Sincronizzazione e backup

Una volta che il server è in funzione, la domanda successiva di solito non riguarda il server in sé. Riguarda i tuoi dati: come faccio concretamente a trasferire tutto ciò che ho sul server?

Sincronizzazione e backup riunisce questi percorsi di migrazione. Questa parte della documentazione tratta il backup del telefono, il backup del computer, le connessioni alle unità cloud, lo spostamento dei dati da un altro NAS, il trasferimento di file tra unità, Time Machine e flussi di lavoro di backup più ampi.

Le foto sono spesso uno dei primi grandi insiemi di dati personali che le persone trasferiscono su un home server. Se vuoi creare una libreria fotografica privata, la guida al backup delle foto con Immich ti offre un percorso pratico per iniziare a eseguire il backup e gestire le foto su ZimaOS.

Che tu stia spostando qualche centinaio di foto dal telefono o sostituendo gradualmente un vecchio NAS o un flusso di lavoro basato sul cloud storage, non devi migrare tutto in un fine settimana. Sposta una fonte alla volta e costruisci il sistema di backup attorno ai dati che ti stanno davvero a cuore.

Accesso e condivisione

Un NAS raggiungibile solo quando sei seduto accanto a lui non è particolarmente entusiasmante.

Accesso e condivisione è il punto in cui ZimaOS inizia a collegare il server al resto dei tuoi dispositivi. La sezione tratta ZimaClient, l'accesso remoto, la condivisione di file SMB, i link di condivisione e le configurazioni Samba multiutente.

Se colleghi un computer o un telefono per la prima volta, la guida all'installazione di ZimaClient è un buon punto di partenza.

Da lì, valuta l'accesso in base alla situazione: condivisione locale dei file per i computer in casa, accesso remoto quando sei fuori casa oppure strumenti di condivisione quando un'altra persona ha bisogno solo di file o cartelle specifici.

Metodi di installazione

ZimaOS non è limitato a un solo metodo di installazione.

Se installi il sistema autonomamente, la guida Come installare ZimaOS illustra la creazione del supporto di installazione, l'avvio del dispositivo, l'installazione del sistema operativo e l'accesso al sistema in seguito.

Questa sezione è particolarmente utile per chi costruisce home server fai-da-te usando hardware x86-64 compatibile, oltre che per gli utenti che sperimentano Proxmox, migrano da CasaOS o gestiscono altre attività relative all'installazione e agli account.

Sistema

Probabilmente non aprirai la sezione Sistema ogni giorno. Ed è una buona cosa.

Quando un server diventa parte del tuo flusso di lavoro quotidiano, l'affidabilità conta più della configurazione. La sezione Sistema tratta gli aspetti meno appariscenti ma importanti della gestione di ZimaOS, tra cui la protezione dall'interruzione di corrente, il ripristino, l'installazione offline, il ripristino della rete, la ricerca e altre attività di manutenzione.

Queste non sono necessariamente le prime guide che leggerai, ma potresti essere contento di sapere che esistono prima del giorno in cui ne avrai davvero bisogno.

2. App Store: decidi cosa vuoi che faccia il tuo server

Portare online lo spazio di archiviazione dà soddisfazione. Di solito è quando installi la prima app davvero utile che un home server inizia a sembrare il tuo home server.

La documentazione dell’App Store di ZimaOS è organizzata intorno ai carichi di lavoro anziché ai dettagli tecnici dell’installazione.

Invece di iniziare dalla domanda «Come configuro Docker?», questa parte della mappa di apprendimento parte da qualcosa di più utile: Che cosa vuoi che faccia il tuo server?

Media Server

Questo è uno dei punti più semplici da cui iniziare con l’auto-hosting. Un server domestico può diventare una libreria privata per film, serie televisive, musica, foto e altri contenuti multimediali che rimangono sotto il tuo controllo.

La sezione Media Server riunisce Jellyfin, Plex, Emby, Immich, i servizi DLNA, i server per telecamere, la migrazione delle foto e i carichi di lavoro multimediali assistiti dalla GPU.

Se Jellyfin è il tuo primo progetto server, la guida alla configurazione di un media server Jellyfin offre un percorso diretto per creare una libreria di streaming privata.

Se la tua prima idea per un server domestico assomiglia più a «Voglio il mio Netflix» o «Voglio togliere le mie foto da un abbonamento cloud», questa è la parte della documentazione da esplorare per prima.

App auto-ospitate

Dopo il media server arriva la parte pericolosa: rendersi conto che puoi auto-ospitare quasi tutto.

Questa sezione tratta strumenti per la sincronizzazione dei file, il blocco degli annunci a livello di rete, la gestione dei documenti, l’automazione dei download, il monitoraggio, la gestione dei contenuti multimediali e altri servizi che normalmente risiederebbero nel cloud.

Non ti servono venti container il primo giorno. Scegli un problema che vuoi risolvere con il tuo server, fai funzionare quel flusso di lavoro e poi aggiungi il servizio successivo.

IA e machine learning

L’IA locale è diventata rapidamente un altro motivo per tenere acceso a casa un server potente.

La sezione IA e machine learning si concentra sui carichi di lavoro in cui modelli, documenti, foto o agenti possono funzionare vicino ai tuoi dati. Il percorso di apprendimento include la distribuzione di modelli locali, la ricerca basata sull’IA, i modelli offline, l’analisi intelligente delle foto e gli agenti IA sempre attivi.

Se ti interessano l’IA privata, gli LLM locali o gli agenti che devono accedere continuamente ai file archiviati sul tuo server, questo è il ramo da seguire.

Creative Builds

Non tutti i progetti di server domestici devono migliorare la produttività. A volte vuoi semplicemente costruire qualcosa perché puoi farlo.

Creative Builds raccoglie progetti più sperimentali, come server di gioco, retrogaming, configurazioni legate alla realtà virtuale, esperimenti di virtualizzazione, app store della community e altri progetti a metà tra un homelab e un hobby del fine settimana.

Per gli utenti di homelab, spesso è proprio qui che un progetto si trasforma silenziosamente in altri tre.

Risorse per sviluppatori

Prima o poi, alcuni utenti si trovano davanti allo stesso problema: l'app che cercano non è ancora disponibile nello store.

Risorse per sviluppatori offre il passaggio successivo a chi vuole creare e pubblicare applicazioni in autonomia, collegando in modo naturale l'utilizzo dell'App Store al contributo all'ecosistema che lo sostiene.

3. Hardware: comprendere la macchina alla base del software

Le guide software rispondono a molte domande, finché la domanda non diventa: «Qual è quella porta?» oppure «Questa macchina può supportare un'altra unità, una scheda di rete, una GPU o un sistema operativo?»

È qui che subentra la documentazione hardware.

Panoramica

La panoramica dell'hardware riunisce le principali famiglie di dispositivi Zima e offre un modo rapido per capire quale percorso della documentazione corrisponde all'hardware che hai davanti.

ZimaCube è progettato per carichi di lavoro più impegnativi, incentrati su NAS, archiviazione, contenuti multimediali ed espansione. ZimaBoard è adatto a server domestici compatti, rete, servizi self-hosted e sperimentazione hardware. ZimaBlade offre un punto di ingresso più compatto per progetti NAS e server fai da te.

Una volta individuata la famiglia con cui stai lavorando, il resto della sezione Hardware diventa molto più facile da consultare.

ZimaCube

Il percorso ZimaCube è pensato per chi lavora con un sistema NAS più grande e orientato all'espansione.

Le guide vanno oltre la configurazione iniziale e trattano interfacce hardware, spazio di archiviazione aggiuntivo, espansione GPU, espansione SSD, configurazione del BIOS, rete, Thunderbolt, raffreddamento, Wake-on-LAN e altre funzionalità specifiche del dispositivo.

Usa questa sezione quando la domanda non è più semplicemente «Come si usa ZimaOS?», ma «Cosa può fare questa specifica configurazione hardware?».

ZimaBoard 2

ZimaBoard 2 è il modello compatto e orientato all'espansione della gamma hardware. È progettato per chi ama sperimentare con server domestici, reti, servizi self-hosted, archiviazione e configurazioni hardware personalizzate.

Se hai appena estratto la scheda dalla confezione, inizia con la guida introduttiva a ZimaBoard 2. Offre un punto di partenza chiaro per la configurazione hardware, prima di passare ad aspetti più avanzati come archiviazione, rete, app, raffreddamento o espansione PCIe.

Da qui, la documentazione di ZimaBoard tratta le interfacce hardware, la procedura di accensione, l'espansione, il raffreddamento, la configurazione della ventola PWM e gli aspetti pratici dell'integrazione della scheda in un progetto homelab più ampio.

Questo rende la stessa scheda adatta a scenari molto diversi: un NAS compatto, un server multimediale, un host Docker, un dispositivo di rete, un nodo di virtualizzazione o un altro servizio self-hosted sempre attivo.

ZimaBlade

ZimaBlade mantiene più semplice il percorso hardware e offre un punto di ingresso accessibile ai server fai da te.

La relativa documentazione si concentra principalmente sull’avvio dell’hardware, sulla comprensione della configurazione di base e sulla preparazione del sistema prima di iniziare ad aggiungervi applicazioni e servizi.

Compatibilità

I server domestici raramente esistono da soli. Unità, gruppi di continuità, adattatori di rete, moduli Wi‑Fi, schede di espansione e altri accessori diventano gradualmente parte del sistema.

La sezione Compatibilità risponde alla domanda pratica su cosa è stato testato e su come configurare hardware specifici.

Ha un obiettivo molto semplice: aiutarti a rispondere alla domanda «Funziona con la mia configurazione?» prima di passare un pomeriggio a chiederti perché non funziona.

Sistemi di terze parti

L’hardware Zima non è vincolato a un unico sistema operativo.

Se il tuo progetto richiede Unraid, TrueNAS, OpenWrt, OpenMediaVault, Ubuntu Server, Arch Linux o un altro ambiente, la sezione Sistemi di terze parti offre un percorso verso distribuzioni alternative.

Ciò significa che la documentazione dell’hardware rimane utile anche quando il tuo progetto finisce per andare oltre ZimaOS.

4. Sviluppatori: vai più a fondo quando le impostazioni predefinite non bastano più

La maggior parte delle persone non ha bisogno di iniziare da qui—ed è proprio questo il punto.

La documentazione per sviluppatori è pensata per il momento in cui le impostazioni predefinite più pratiche non sono più sufficienti e vuoi avere un controllo maggiore sul sistema sottostante.

Panoramica

La panoramica per sviluppatori è il ramo avanzato della mappa di apprendimento, pensato per utenti esperti, costruttori di homelab, sviluppatori e chiunque voglia andare oltre l’interfaccia standard di ZimaOS.

Se sai già cosa stai cercando—ZFS, SSH, API, app personalizzate o funzionalità di rete più avanzate—non è necessario seguire prima le guide per principianti. Inizia da qui.

Archiviazione e filesystem

Questa sezione va oltre la configurazione quotidiana dei dischi e tratta tecnologie come ZFS, configurazioni RAID avanzate, NFS, iSCSI, archiviazione crittografata, rsync, procedure di ripristino e connessioni con altri sistemi NAS.

Se la sezione Configurazione e archiviazione di ZimaOS risponde alla domanda «Come devo configurare le mie unità?», la sezione Archiviazione per sviluppatori inizia a rispondere a una domanda diversa: «Come funziona lo stack di archiviazione e quanto controllo posso avere su di esso?»

Reti e protocolli

Quando un homelab cresce, la rete diventa parte del progetto invece di essere qualcosa che semplicemente funziona in background.

Reti e protocolli copre la configurazione della rete, l’accesso SSH, le impostazioni SSH avanzate, le prestazioni di trasferimento e i protocolli usati per connettere ZimaOS ad altri computer.

Questa è la tappa successiva naturale quando inizi a lavorare con più server, reti più veloci, shell remote o configurazioni di rete più avanzate.

Sviluppo

Questo ramo serve per costruire sul sistema stesso.

Per gli utenti che vogliono automatizzare il proprio server o contribuire all'ecosistema, la sezione Sviluppo tratta gli ambienti di scripting, i flussi di lavoro per i contributi e lo sviluppo guidato dalla community.

Anche se non stai creando un'applicazione completa, un piccolo script può diventare sorprendentemente utile quando ti evita di ripetere ogni settimana la stessa attività amministrativa.

Sviluppo per l'App Store

Eseguire app e crearle sono due fasi diverse dello stesso percorso.

Lo sviluppo per l'App Store è pensato per chi vuole impacchettare applicazioni Docker, pubblicarle per gli utenti di ZimaOS, creare cataloghi di app, lavorare con i metadati di Docker Compose, gestire risorse e localizzazione o automatizzare i flussi di lavoro per la pubblicazione delle app.

Se la sezione App Store è il parco giochi, questa è l'officina che si trova dietro di essa.

API di ZimaOS

Quando fare clic manualmente sui pulsanti non è più sufficiente, l'API diventa il livello successivo.

La sezione API di ZimaOS offre un percorso verso il controllo programmatico, l'autenticazione, le integrazioni, gli endpoint disponibili e gli strumenti per esplorare come altre applicazioni possono comunicare con ZimaOS.

Questo apre la porta a script personalizzati, dashboard, strumenti di gestione e integrazioni sviluppati intorno al tuo ambiente server domestico.

Registro delle versioni

L'area Sviluppatori mantiene inoltre la cronologia delle versioni di ZimaOS accanto alla documentazione tecnica.

Questo diventa utile quando il comportamento cambia tra una versione e l'altra, quando vuoi capire quando è stata introdotta una funzionalità o quando una guida dipende da funzioni introdotte in una versione più recente di ZimaOS.

5. Centro assistenza: inizia dal sintomo

A volte non vuoi imparare un nuovo protocollo di archiviazione. Vuoi solo che la macchina si avvii di nuovo.

Il Centro assistenza ZimaSpace è deliberatamente il percorso più breve sulla mappa. Invece di richiederti di comprendere prima la causa principale, ti permette di iniziare dal problema che puoi effettivamente vedere.

Panoramica

Se sei arrivato qui, è molto probabile che qualcosa non si stia già comportando come previsto.

Il Centro assistenza indirizza gli utenti verso materiali per la risoluzione dei problemi e di riferimento, invece di costringerli a cercare in ogni guida alla configurazione per capire se il problema riguarda il software, l'archiviazione, la rete o l'hardware.

Risoluzione dei problemi

Se il dispositivo non si avvia, la creazione del RAID non riesce, una connessione di rete scompare, è necessario testare la memoria, il BIOS richiede attenzione o un collegamento hardware non funziona, inizia da qui.

Il percorso di risoluzione dei problemi è progettato per ridurre la distanza tra:

“Qualcosa non va” → “Sembra proprio il mio problema” → “Ecco cosa controllare.”

Di solito è più utile che aspettarsi che qualcuno sappia se un problema appartiene al sistema operativo, al livello di archiviazione, allo stack di rete o all'hardware prima ancora di iniziare a cercare aiuto.

Riferimenti

Non tutte le pagine utili devono essere guide dettagliate passo dopo passo.

L'area di riferimento raccoglie informazioni di supporto e materiale tecnico che gli utenti potrebbero dover consultare occasionalmente, senza seguire un tutorial completo.

Community: quando la documentazione è solo l'inizio

La documentazione funziona al meglio quando il problema ha già una risposta chiara. I server domestici non sono sempre così collaborativi.

Forse la tua configurazione combina una scheda di rete, un controller di archiviazione, uno stack Docker e una versione del sistema operativo per cui non è stata scritta alcuna guida specifica. Forse vuoi sapere come un altro utente ha risolto lo stesso problema di archiviazione di Immich. Oppure potresti aver creato qualcosa di abbastanza utile da dover essere condiviso con altre persone.

È qui che la Community di ZimaSpace diventa il livello successivo della mappa di apprendimento.

La Community riunisce diversi tipi di conoscenze difficili da acquisire nella documentazione statica:

• Risoluzione dei problemi nel mondo reale: scopri come altri utenti diagnosticano problemi insoliti di ZimaOS, delle app, dell'archiviazione, della rete e dell'hardware.
• Tutorial della community: scopri flussi di lavoro e configurazioni creati da persone che usano ZimaOS nei propri ambienti.
• Esperimenti hardware: confronta schede di espansione, configurazioni di rete, configurazioni di archiviazione, progetti di virtualizzazione e altre configurazioni homelab.
• Feedback e idee: suggerisci funzionalità, segnala problemi e discuti di come migliorare ZimaOS e l'hardware Zima.
• Annunci: segui i rilasci di ZimaOS, gli aggiornamenti dei prodotti, i progetti della community e gli altri cambiamenti nell'ecosistema.

Una regola utile è semplice: usa la documentazione quando ti serve il percorso consolidato; usa la Community quando vuoi vedere come le altre persone lo stanno realmente percorrendo.

Se non riesci a trovare subito la risposta, torna alla home page della documentazione di ZimaSpace oppure continua la conversazione nella Community di ZimaSpace.

FAQ: orientarsi nella nuova documentazione di ZimaSpace

Da dove dovrebbe iniziare un nuovo utente di ZimaOS?

Inizia con la guida Inizia a usare ZimaOS. Da lì, il percorso naturale passa solitamente per Configurazione e archiviazione, Sincronizzazione e backup, quindi Accesso e condivisione, prima di aggiungere altre applicazioni.

Devo leggere tutte e cinque le sezioni della documentazione in ordine?

No. La documentazione funziona meglio come una mappa che come un libro. Un nuovo utente può iniziare da ZimaOS, mentre un utente esperto di homelab che cerca informazioni su ZFS o SSH può passare direttamente alla documentazione per sviluppatori. Se qualcosa è già guasto, inizia dal Centro assistenza.

Dove posso trovare le guide su spazio di archiviazione e RAID di ZimaOS?

Per la normale pianificazione dello spazio di archiviazione, inizia con la guida alla configurazione dello spazio di archiviazione di ZimaOS. Per argomenti più approfonditi, come ZFS, RAID avanzato, NFS o iSCSI, prosegui in Sviluppatore → Archiviazione e file system.

Dove posso trovare Jellyfin, Plex, Immich o altre app self-hosted?

Inizia dalla documentazione dell’App Store. Server multimediale include servizi come Jellyfin, Plex, Emby, Immich, DLNA e relativi flussi di lavoro multimediali, mentre App self-hosted comprende una gamma più ampia di servizi.

Dove posso trovare le guide sull’IA locale?

Apri la documentazione dell’App Store e segui la sezione IA e machine learning. Riunisce modelli locali, ricerca basata sull’IA, funzioni intelligenti per le foto, flussi di lavoro di IA offline e progetti con agenti.

Da dove dovrei iniziare con ZimaBoard 2?

Inizia con la guida introduttiva a ZimaBoard 2. Da lì puoi passare a spazio di archiviazione, rete, espansione, raffreddamento, ZimaOS o sistemi di terze parti, a seconda di ciò che vuoi realizzare.

Posso installare ZimaOS sul mio hardware x86?

Sì. La guida Come installare ZimaOS illustra la procedura di installazione per hardware x86-64 compatibile, risultando utile sia per progetti NAS fai da te e home server, sia per l’hardware Zima.

Posso installare un altro sistema operativo sull’hardware Zima?

Sì. La documentazione hardware include una sezione Sistemi di terze parti per gli utenti che sperimentano sistemi operativi alternativi per NAS, Linux o networking.

Dove posso trovare la documentazione su API, SSH, ZFS o networking avanzato?

Vai direttamente alla documentazione per sviluppatori. È il ramo avanzato dedicato a storage, networking, sviluppo, sviluppo dell'App Store e API di ZimaOS.

Quando dovrei usare la community ZimaSpace invece della documentazione?

Usa la documentazione quando ti serve un percorso consolidato per configurazione, impostazione o risoluzione dei problemi. Usa la community ZimaSpace quando la tua configurazione è insolita, vuoi confrontare esperienze reali, hai bisogno dell'aiuto di altri utenti, vuoi condividere la tua soluzione o hai un feedback che potrebbe contribuire a migliorare l'ecosistema.

Cosa devo fare se non so quale sezione contiene il mio problema?

Se qualcosa ha smesso di funzionare, inizia dal Centro assistenza e cerca il sintomo che corrisponde al tuo problema. Se stai cercando di costruire o configurare qualcosa di nuovo, torna alla pagina iniziale della documentazione ZimaSpace e scegli il percorso più vicino al tuo obiettivo. Se la tua situazione esula dal percorso documentato, poni la domanda alla community ZimaSpace.

Un server domestico non ha davvero un livello finale. C'è sempre un'altra unità da aggiungere, un'altra app da provare, un altro backup da migliorare o un altro strano progetto da weekend in attesa di essere realizzato.

La nuova documentazione è pensata proprio per questo tipo di percorso. Inizia da dove ti trovi, segui il ramo che corrisponde a ciò che stai costruendo e approfondisci quanto richiede il tuo progetto. E quando il percorso documentato finisce, probabilmente c'è qualcuno nella community che ha già provato ad andare un po' oltre.

Esplora la nuova documentazione di ZimaSpace →

Hai una domanda, una soluzione alternativa o una configurazione da condividere? Unisciti alla community ZimaSpace →