Guida all'amministrazione di LGM-OS

56 min · 22 sezioni

Questo documento è il manuale di tutti i giorni: copre dall'inizio alla fine ciò che si fa dal pannello. Quando un argomento ha bisogno di più dettaglio di quanto ne stia qui, ha la sua guida:

Indice completo della documentazione: index.md.

I primi dieci minuti

Questo è il percorso completo da quando accendi il dispositivo fino ad avere il NAS che fa qualcosa di utile. È pensato per essere fatto di seguito, in ordine, e ogni passaggio dice perché conta —quelli che si saltano perché non si capiscono sono proprio quelli che mancano il giorno brutto—.

1. Entrare (1 min)

Apri https://<ip-del-nas>:5001. L'IP lo mostra la console del dispositivo stesso all'avvio.

Il certificato è autofirmato e il browser avvisa: è normale su una macchina di casa tua —accettalo—. Se ti dà fastidio, lo si sostituisce con uno vero più avanti (vedi Accesso da internet).

La procedura guidata del primo accesso ti chiede di creare l'amministratore: nome in minuscolo e password di almeno 8 caratteri. Non c'è un utente né una password di fabbrica, quindi nessuno può entrare prima di te.

2. Preparare i dischi (2 min)

Archiviazione → Crea volume. Ti offre solo dischi che si possono usare: quello di sistema non compare mai, e uno con dati dentro viene segnalato perché tu non lo formatti senza volerlo.

• Un solo disco: va bene, ma non protegge da nulla. Basta per cominciare.
• Due o più: scegli mirror. Se uno muore, non si perde nulla e lo si cambia dal pannello. È la differenza tra uno spavento e una perdita.
• Btrfs o ZFS: Btrfs se non hai chiaro quale (è quello che chiede meno memoria); ZFS se metterai molta RAM e vuoi il massimo dell'integrità.

Alla fine, il NAS crea da solo le cartelle di sistema (docker, vm) e tre condivise: Galeria per le foto, Musica per le canzoni e Peliculas per la videoteca.

3. Una cartella e un account per persona (3 min)

Pannello di controllo → Cartelle della casa → «Crea». Dagli un nome corto e senza accenti (viaggia verso Windows, il Mac e il telefono).

Pannello di controllo → Utenti e gruppi → un account per persona, non uno condiviso. È ciò che permette di dare permessi diversi, vedere chi è entrato e togliere l'accesso a uno solo senza cambiare la password a tutta la casa.

Su ogni cartella, l'interruttore SMB la pubblica in rete. Da Windows si apre con \\<ip-del-nas>; da un Mac, con Cmd+K → smb://<ip-del-nas>.

4. Il backup (3 min)

Questo è il passaggio che nessuno fa e che tutti rimpiangono. Un NAS con mirror protegge dalla rottura di un disco; non protegge da un'eliminazione per errore, da un ransomware né dall'incendio della casa. Per questo serve un backup FUORI.

Backup → «Nuovo» → scegli quali cartelle e dove (un disco USB, un altro dispositivo via SSH o il tuo cloud). Guida completa: Backup.

E l'unica cosa non facoltativa: ripristina un file qualsiasi per verificare che il backup serva. Un backup mai ripristinato non è un backup, è una cartella grande.

5. Chiudere la porta (1 min)

• Pannello di controllo → Sicurezza → attiva la verifica in due passaggi.
• Pannello di controllo → Firewall → attivalo. Il pannello e SSH restano sempre permessi, quindi non puoi chiuderti fuori.
• Pannello di controllo → Avvisi → configura l'email o il webhook e premi «Invia prova». Senza questo, il NAS non ha modo di avvisarti che un disco si sta guastando.

Ed è fatta

Da qui in poi, il resto si aggiunge quando serve: applicazioni, telecamere, accesso da fuori o VPN. Il resto di questa guida è il riferimento, argomento per argomento.

Archiviazione

• Crea volume: Archiviazione → «Crea volume». La procedura guidata offre solo dischi idonei (mai il disco di sistema). ZFS per la massima integrità (RAID-Z1/Z2), Btrfs per la flessibilità (RAID1/10). Formattare distrugge i dati dei dischi.
• Dataset: suddivisioni con quota e compressione proprie (scheda Dataset).
• Istantanee: scheda Istantanee per quelle manuali; Pannello di controllo → Attività pianificate per quelle automatiche con conservazione. Il ripristino ZFS usa rollback (elimina le istantanee successive); quello di Btrfs crea una copia scrivibile restaurado-<data> da controllare prima.
• Salute: la scheda Salute mostra SMART e permette di avviare gli scrub. Pianifica uno scrub mensile con un'attività. Un disco con SMART «IN ERRORE» va sostituito subito: in «Dischi dei pool» di quella stessa scheda si sostituisce il disco guasto con quello nuovo (e si amplia il pool con dischi aggiuntivi) senza scendere alla console.

Backup

Istantanee e RAID vivono dentro il dispositivo: non proteggono da un incendio, da un furto né da un ransomware. Per questo c'è l'app Backup, che porta i dati fuori dal NAS.

• Destinazioni: locale (un disco USB collegato al NAS o un altro pool) o remota tramite **rsync su SSH** (un altro NAS o server: casa di un familiare, l'ufficio, un VPS). Il NAS genera la sua chiave SSH e basta autorizzare la parte pubblica sul dispositivo di destinazione. Ogni destinazione si prova scrivendoci davvero prima di affidarle qualcosa. Il pannello elenca inoltre S3 come non disponibile, con il motivo: caricare su S3 richiede di firmare ogni richiesta dal processo privilegiato, e quel processo esegue solo binari della allowlist. È dichiarato nel contratto dell'API per non romperlo il giorno in cui verrà implementato, ma oggi l'API rifiuta una destinazione S3 invece di fingere che funzioni.
• Attività: cartelle di origine, destinazione, orario e quante versioni (o quanti giorni) si conservano. Ogni backup è incrementale: viaggia solo ciò che è cambiato, e le versioni precedenti restano complete tramite hard link (rsync --link-dest), quindi occupano poco. Girano con avanzamento come le altre attività lunghe e avvisano tramite gli avvisi se falliscono (configura Pannello di controllo → Avvisi: un backup che fallisce in silenzio non è un backup). **La cifratura della destinazione non è ancora disponibile** e l'API la rifiuta esplicitamente: se la destinazione è un disco che esce di casa, cifralo tu sul dispositivo di destinazione (LUKS) o conservalo in un posto di fiducia.
• Ripristino dall'app stessa: scegli la versione e la cartella di destinazione. La cronologia conserva ogni esecuzione con la sua dimensione e il suo errore esatto.

Cosa copiare, ogni quanto, come autorizzare la chiave passo passo e —la cosa più importante— come verificare che il backup serva ripristinandolo davvero: backups.md.

Condivisione dei file

Le cartelle si condividono da Cartelle della casa, e i distintivi SMB, NFS e WebDAV di ciascuna si premono per accendere o spegnere quel protocollo senza aprire l'editor.

Il NAS compare da solo in rete. Con SMB acceso non bisogna sapere l'IP né configurare nulla sui dispositivi: compare in «Rete» di Windows, nella barra laterale del Finder di macOS e nell'esploratore di file di Linux. Condividere e annunciarsi sono cose diverse, ed è per questo che il firewall apre cinque porte, non due:

Le ultime tre annunciano solo che questo dispositivo esiste; non danno accesso a nulla. Si aprono e si chiudono con l'interruttore di SMB, quindi spegnerlo le ritira tutte.

Sul protocollo: si negozia il più alto che ammettono le due parti, e con Windows 10/11, macOS e Linux moderni è SMB 3.1.1 con cifratura. Il minimo resta SMB2 di proposito, per non lasciare fuori un televisore o uno scanner che parlano solo quella versione.

Chi vede cosa

Si nega di default, e vale per tutte le porte. Una cartella della casa senza elenco dei permessi è degli amministratori e di nessun altro: non compare collegandosi a \NAS, non si apre, e non ci si arriva nemmeno via NFS né dalla console. Perché qualcuno entri bisogna darglielo nella scheda Cartelle della sua scheda.

Gli amministratori entrano sempre in tutte, oltre a ciò che dice ogni elenco. È il secondo giro di chiave: se qualche controllo del pannello si salta, serve comunque essere amministratore. L'eccezione è un «nessun accesso» messo di proposito su una persona precisa, che comanda su tutto il resto — anche se quella persona amministra.

La mia unità. Ogni account ha la sua cartella privata, in <volume>/homes/<account>/archivos. Compare in File ed è anche dove entra il suo SFTP. È dove si lasciano le proprie cose senza montare una cartella della casa, e arriva con le sue cartelle Foto, Musica, Video, Documenti e Download già pronte. Nessun altro ci entra — né gli altri account dalla rete, né scrivendo il percorso nel pannello — tranne in ciò che il suo proprietario condivide con il pulsante «Condividi» (Utenti e permessi). Nemmeno chi amministra, finché non accende «Vedere il contenuto di tutti gli account».

In rete esce come una cartella della casa in più. In Cartelle della casa ha la sua riga, sopra le altre, con un interruttore generale e i distintivi SMB, NFS e WebDAV; ogni persona entra nella sua e solo nella sua da uno qualsiasi di loro, senza permessi da distribuire:

• SMB, acceso di fabbrica: collegandosi a \\NAS, come home o con il nome dell'account.
• NFS non chiede password, quindi si accende solo con l'elenco dei dispositivi che possono montarla (il loro IP o la loro rete), e solo quelli la montano.
• WebDAV la mette in https://<NAS>:8081/~<account> (o sulla porta che ha WebDAV), per gli account con «Accesso web ai file» nella loro scheda. È anche la strada da cui LGM Connect la apre da fuori casa.

Spenta, «La mia unità» non esce da nessuno dei tre, ma i file non vengono toccati e si continua a vedere in File. L'SFTP va a parte: si concede nella scheda di ogni account ed entra sempre nella sua «La mia unità», comunque sia l'interruttore.

Ciò che non è tuo, non si vede. Né nel pannello né nell'elenco delle cartelle di Windows: si mostrano solo le cartelle che quell'account può aprire, quindi non si leggono nemmeno i nomi. Un amministratore entra in tutte le cartelle della casa, come sempre; le unità degli altri le vede solo con «Vedere il contenuto di tutti gli account» acceso, e solo per guardare.

Il Pannello di controllo, per ruolo. Un account normale ci trova tre cose: le informazioni sul dispositivo, la sua password e il suo secondo fattore, e la regione e l'aspetto. Il resto sono schermate di amministrazione e non gli vengono offerte; se ci arriva da un link diretto, glielo si dice.

Una persona, un account

Si gestisce tutto in Utenti e gruppi. Ogni persona ha una password e quattro capacità che si segnano nella sua scheda:

Togliere la spunta a una capacità la ritira davvero. La scheda Cartelle della sua scheda distribuisce l'accesso cartella per cartella: nessun accesso, lettura e scrittura, o sola lettura, e mostra inoltre ciò che eredita dai suoi gruppi. Salvando senza scrivere una password si conserva quella che aveva; ne serve una nuova solo per registrarla in un servizio che non aveva ancora.

Nella stessa scheda, «Account per bambini» (solo per chi entra nel pannello, e solo lo imposta chi amministra): quella persona vedrà in Film e serie unicamente ciò che è classificato come adatto fino a 12 anni, e niente di ciò che non ha classificazione. Il filtro lo fa il NAS e non lo schermo, quindi non lo si aggira incollando l'indirizzo di un film. Vedi «Film e serie».

Il pannello non permette di restare senza amministratore: né togliendosi l'accesso da soli, né declassando o eliminando l'ultimo che resta.

Rapporto dei file

Edizione Business. Nel «⋯» di ogni cartella della casa, Rapporto dei file mostra ciò che è più grande, ciò che nessuno tocca dai mesi che scegli e quanto occupa ogni persona. Lo fa lo stesso misuratore che mostra le dimensioni in File, una cartella alla volta e senza fretta, quindi non rallenta il NAS; in una cartella enorme può richiedere tempo, e intanto puoi chiudere la finestra. Se il volume non annota quando si apre un file, «non toccato» vuol dire «non modificato», e il rapporto lo dice.

Un solo percorso per tutta l’azienda

Edizione Business. In Servizi file → SMB puoi creare una cartella di rete —\\<NAS>\datos, con il nome che scegli— che riunisce cartelle di questo NAS e di altri server. Chi la apre le vede tutte insieme e, entrando in una, il suo dispositivo va al server dove si trova, con i permessi di sempre.

• Le cartelle di questo NAS si scelgono dall’elenco; per un altro server si scrive il suo nome (nas2 o nas2.azienda.local) e la cartella condivisa.
• Quando ne aggiungi una, il pannello verifica che quel server risponda; se no, non si salva.
• Toglierla dal percorso non tocca la cartella di destinazione.

NFS con gli account del dominio

Edizione Business. Via NFS il NAS si fida del dispositivo dall’altra parte, quindi l’elenco dei dispositivi è l’unica barriera. Con il NAS unito a un dominio (Servizio di directory), la scheda di una cartella con NFS permette di scegliere Chi può montarla: i dispositivi dell’elenco, come sempre, o ogni persona con il suo account del dominio (Kerberos), con tutto firmato o tutto cifrato. Firmato e cifrato sono un po’ più lenti, e il dispositivo deve essere unito allo stesso dominio. La prima volta in una cartella, il NAS verifica di avere la sua chiave NFS nel dominio; se no, non si salva e ti dice cosa fare.

Cercare file

• La ricerca di File si appoggia a un indice dei nomi che il NAS mantiene da solo: un passaggio ogni due minuti che guarda solo le cartelle la cui data è cambiata, quindi non rilegge l'intero disco né si nota. Cercare diventa istantaneo e, soprattutto, completo: il percorso dal vivo si arrendeva alle 60 000 voci e restituiva «c'è più di quanto si mostra».
• L'indice vive nello stato del sistema (/var/nas/state/indice.db), non accanto ai tuoi dati, e conserva solo percorsi: chi può vedere cosa continua a deciderlo la cartella della casa a ogni ricerca. Occupa poco —circa 20 MB ogni 150 000 file— e se si elimina, si ricostruisce da solo.
• La prima volta richiede il tempo che serve a leggere l'albero —da qualche secondo a una notte, secondo quanti file ci sono—, e nel frattempo la ricerca funziona come prima, percorrendo.
• Ciò che crei, carichi, sposti o elimini dal pannello si annota all'istante; ciò che arriva via SMB o NFS compare al passaggio successivo.
• Affinare la ricerca non richiede di premere di nuovo Invio: una volta dentro i risultati, cambiare la parola li rifà da sola. Solo quando l'indice è pronto; altrimenti, si continua a cercare premendo Invio, per non mandare il NAS a percorrere il disco a ogni tasto.
• Cercare dentro il contenuto (la casella della ricerca) si appoggia anch'esso all'indice —gli chiede quali documenti ci sono e in che ordine, dal più recente al più vecchio— ma li apre e li legge in quel momento, con i loro limiti: indicizzare il testo di tutto costerebbe davvero disco e CPU.

Le cartelle di sistema

In «Cartelle della casa» compaiono anche quelle create dal NAS stesso: docker (i dati delle applicazioni), vm (i dischi delle macchine virtuali), camaras (le registrazioni), Galeria (le foto e i video), Musica (le canzoni) e Peliculas (la videoteca). Si possono condividere in rete, dar loro cestino e permessi, ma non si rinominano, né si spostano, né si eliminano: toglierle da sotto lascia le telecamere, la Galleria, Musica e Film puntati a una cartella che non esiste più. Hanno la loro etichetta SISTEMA nell'elenco, e quelle che esistevano già nel tuo NAS la ricevono aggiornando. Dentro la tua «La mia unità» puoi creare cartelle con quegli stessi nomi: lì non riservano nulla. Compaiono solo quando il volume è preparato —ha le sue cartelle docker, vm e appstore—, cosa che fino a poco fa succedeva solo nei volumi creati dal pannello: uno adottato o arrivato da una reinstallazione ne restava senza. Il NAS ora lo ripassa ogni dieci minuti e le crea se mancano.

Foto e video (Galleria)

• Il NAS crea una cartella della casa «Galeria» la prima volta che c'è un volume: è il posto ovvio dove lasciare le foto (si vede in File, si condivide in rete e il telefono può copiarci il rullino), e la Galleria la indicizza sempre. È una cartella di sistema, quindi non si rinomina né si elimina dal pannello. Senza accento perché il nome di una cartella della casa viaggia verso SMB, NFS e un percorso del disco.
• La Galleria non copia né sposta nulla: legge le foto e i video che sono già nelle tue cartelle della casa e li ordina in una linea del tempo per mesi.
• Si aggiorna da sola, ogni mezz'ora. Ciò che arriva via SMB —la copia del rullino del telefono, che è come arrivano quasi tutte— compare senza che nessuno prema nulla; «Cerca nuove foto» resta per quando non vuoi aspettare. Se non scegli cartelle, indicizza «Galeria» e le condivise il cui nome sa di foto o di video (Fotos, Photos, Imágenes, DCIM, Vídeos); dall'app stessa si possono scegliere a mano. Non entrano né la cartella delle telecamere di sorveglianza né una videoteca di film: quelli non sono ricordi.
• L'indice è un SQLite a parte e si riempie in background: il primo passaggio di una cartella grande richiede tempo, e l'app dice che sta analizzando nel frattempo. Smettere di condividere una cartella la toglie dall'indice al passaggio successivo.
• Gli album sono elenchi, non cartelle: una foto può stare in diversi e creare, rinominare o eliminare un album non tocca nemmeno un file del disco. Scaricarne uno dà uno zip.
• I video si servono per intervalli, quindi si può saltare a un minuto preciso senza scaricare l'intero file, e la loro miniatura è un fotogramma del secondo 1.
• Quali formati entrano: JPEG (incluso .jfif), PNG, WebP, AVIF, GIF, BMP, TIFF, HEIC/HEIF (iPhone) e RAW della fotocamera —.cr2, .cr3, .nef, .nrw, .arw, .sr2, .rw2, .orf, .raf, .pef, .srw, .rwl, .3fr, .erf— compreso il ProRAW dell'iPhone, che è un .dng. In video: .mp4, .mov, .m4v, .mkv, .webm, .avi, .3gp, .mts e .m2ts.
• Il RAW non si sviluppa (richiede un intero processore d'immagine e secondi per foto): si mostra l'anteprima che la fotocamera ha lasciato dentro il file, che è un JPEG quasi a dimensione piena ed è ciò che fanno tutte le gallerie. La estrae exiftool; gli HEIC li apre heif-convert. Li installa LGM-OS; se mancano, quelle foto si indicizzano comunque ma restano senza miniatura e il pannello lo dice.
• Live Photo: l'iPhone salva ognuna come due file (IMG_0042.HEIC e IMG_0042.MOV). La Galleria li riconosce dal nome e mostra un solo elemento, con l'etichetta «Live» e un pulsante nel visualizzatore per vedere il movimento.
• Eliminare dalla Galleria manda nel cestino del NAS: si recupera da File.
• La ricerca dei duplicati raggruppa per dimensione e inizio del file, e non lascia mai eliminare l'ultima copia rimasta di una foto.

Musica

• Il NAS crea una cartella della casa «Musica» la prima volta che c'è un volume: è il posto ovvio dove lasciare le canzoni —si vede in File e si condivide in rete, quindi la discoteca si trascina dal computer—, e Musica la guarda sempre. È una cartella di sistema: non si rinomina né si elimina dal pannello. Senza accento perché il nome di una cartella della casa viaggia verso SMB, NFS e un percorso del disco.
• Non copia né sposta nulla: legge i file audio che sono già nelle tue cartelle della casa e li ordina per artista, per album e per cartella. L'indice è un SQLite a parte; eliminarlo non tocca nemmeno una canzone, e l'analisi successiva lo rifà.
• Si aggiorna da sola. Guarda se qualcosa è cambiato ogni dieci minuti e fa un passaggio completo ogni ora; «Cerca musica» resta per quando non vuoi aspettare.
• Se non scegli cartelle, guarda in tutte le condivise. La musica di una casa sta in «Musica», in «Dischi», in «CD» e nella cartella di ciascuno, quindi indovinare dal nome lascerebbe l'app vuota senza dire perché; filtrare per estensione non costa nulla. Dalla schermata stessa si possono restringere (lo decide chi amministra: vale per tutta la casa).
• Formati: .mp3, .flac, .m4a, .aac, .ogg, .opus e .wav.
• I titoli compaiono prima dei dati. Durante l'indicizzazione, il nome del file fa da titolo e quello della cartella da album, quindi si può ascoltare dal primo momento; l'artista, l'anno, la traccia e la durata si leggono dopo, a gruppi e in background. Su un dispositivo senza ffmpeg resta alla prima cosa e la schermata lo dice in una riga.
• Copertine: il cover.jpg (o folder.jpg, o front.jpg) della cartella del disco. Se non c'è, si estrae quella dentro il file stesso, copiandola senza ricodificare. Un album senza nessuna delle due si disegna con la sua iniziale: non è un errore.
• Completa da internet (spento di fabbrica, lo accende chi amministra). Il NAS invia i nomi dei tuoi artisti, dischi e canzoni a sette cataloghi liberi e senza chiave —MusicBrainz, Cover Art Archive, Deezer, iTunes, TheAudioDB, Wikipedia e LRCLIB— e porta copertina, data di pubblicazione, generi, nome corretto dell'artista, la sua foto, la sua biografia e il testo delle canzoni. Non si invia nessun file né alcun tuo dato, e non si tocca nemmeno una canzone. Ciò che è di casa comanda sempre: l'anno delle tue etichette vince su quello del catalogo, e il cover.jpg e la copertina incorporata vincono su quella di internet. Si completa poco a poco in background —i cataloghi accettano poche richieste al secondo e il NAS lo rispetta—; «Completa ora» fa un gruppo lungo senza aspettare.
• Correggere a mano (con «Completa da internet» acceso, e solo chi amministra). L'abbinamento automatico preferisce lasciare un disco senza copertina piuttosto che mettergli quella di un altro, quindi con una cartella chiamata «Disco 1» non riconosce nulla. Il pulsante Correggi dell'intestazione di un disco, di quella di un artista e del menu di ogni canzone cerca quel nome nel catalogo e mostra i candidati con la loro copertina: scegliendone uno si applica la sua scheda, e l'artista del disco va a tutte le sue canzoni che non ne hanno nessuno —che è ciò che toglie il «Senza artista» di metà discoteca rippata—. Ciò che è scelto a mano non si riabbina da solo, e su una canzone si può annullare per tornare a ciò che diceva il suo file.
• Riconoscere canzoni senza etichette (spento di fabbrica, lo accende chi amministra). Le canzoni arrivate come Track01.mp3 —da un CD rippato senza consultare nulla— si identificano dal loro suono: il NAS calcola un riassunto acustico dei primi due minuti, lo chiede al catalogo libero AcoustID e gli mette titolo, artista e disco. Non si invia nessun file, solo quel riassunto, e non si tocca nemmeno una canzone: ciò che è riconosciuto si scrive nella libreria. Nella riga di ogni canzone c'è un pulsante per riconoscerla subito e, in quelle già riconosciute, per riportarle a ciò che diceva il loro file. Si guarda solo ciò che sembra senza etichette (senza artista, o con titoli come «Traccia 3» o «AudioTrack 07»); ciò che è già a posto non si tocca. Ciò che è riconosciuto entra poi in «Completa da internet» come qualsiasi altra canzone, e così gli arrivano copertina e data.
• Serve una chiave gratuita: registrati su acoustid.org/new-application e incollala nelle impostazioni di Musica. Senza chiave la funzione si spiega e non si attiva; la chiave si verifica con AcoustID prima di essere salvata e non viaggia nel backup.
• Testi: si chiedono quando si apre una canzone, non durante l'indicizzazione, e si salvano. Se il testo è sincronizzato, la riga che suona si evidenzia e toccare una riga salta a quel momento. Un file .lrc o .txt con lo stesso nome accanto alla canzone comanda su internet e funziona anche se «Completa da internet» è spento.
• La musica si serve per intervalli, quindi si può saltare a un minuto preciso senza scaricare l'intera canzone. Continua a suonare cambiando scheda e con la finestra ridotta a icona.
• Le playlist e le preferite sono di ciascuno: nessun altro le vede, ed eliminare una playlist non tocca nemmeno un file del disco.
• Il confine è quello di sempre: ciò che non puoi aprire in File non compare qui, né il suo nome né la sua copertina.

Radio

• Migliaia di emittenti internet, nella scheda «Radio». Vengono dal catalogo libero radio-browser.info: non bisogna creare nessun account né incollare nessuna chiave.
• Si cerca per nome, per paese (il tuo è già impostato) e per argomento. Senza cercare nulla si mostrano le più ascoltate del tuo paese.
• Il suono passa dal NAS, non dal tuo browser. È ciò che fa suonare anche le emittenti che trasmettono ancora in chiaro —un browser le blocca dentro una pagina sicura, senza dire nulla— e, già che c'è, l'emittente vede una sola connessione invece di quella di ogni telefono e ogni computer di casa.
• Si verifica che l'emittente suoni prima di metterla. Un catalogo aperto ha emittenti spente da anni: per questo premere richiede un secondo in più e, quando qualcosa non va, si dice cosa succede («non ha cominciato a suonare in 10 secondi») invece di lasciare il lettore muto.
• Le tue emittenti sono tue: quelle salvate e le ultime ascoltate non le vede nessun altro, nemmeno chi amministra. Viaggiano nel backup della configurazione.
• Suona nel lettore di sempre: resta attiva cambiando scheda e si gestisce dai tasti multimediali della tastiera e dalla schermata di blocco del telefono.

Podcast

• Iscriviti con il suo nome o incollando l'indirizzo del suo RSS, nella stessa casella. I nomi si cercano nel catalogo pubblico di iTunes; da lì in poi il NAS parla direttamente con chi pubblica il podcast.
• Ognuno segue i suoi. Nessuno vede a cosa ti iscrivi né dove sei arrivato, nemmeno chi amministra. Il programma si scarica UNA volta anche se lo seguono tre persone di casa.
• Si aggiorna da solo ogni sei ore, e «Aggiorna» lo fa subito. Se un programma smette di rispondere, la sua scheda lo dice e i suoi episodi restano.
• Avvisami dei nuovi episodi: un interruttore per persona. Arriva un avviso per programma e per passaggio, mai uno per episodio.
• Si ricorda dove eri arrivato in ogni episodio, come in Film e serie, e lo si può segnare come ascoltato a mano. Anche qui l'audio passa dal NAS, e saltare a un minuto preciso continua a funzionare.
• Ciò che si scarica è l'elenco degli episodi, non l'audio: **gli episodi non occupano spazio nel NAS**.

Film e serie

• Il NAS crea una cartella della casa «Peliculas» la prima volta che c'è un volume: è il posto ovvio dove lasciare film e serie —si vede in File e si condivide in rete, quindi si trascinano dal computer—, e l'applicazione la guarda sempre. È una cartella di sistema: non si rinomina né si elimina dal pannello. Senza accenti né spazi perché il nome di una cartella della casa viaggia verso SMB, NFS e un percorso del disco.
• Non copia né sposta nulla: legge i video che sono già nelle tue cartelle della casa e li ordina in film e serie. L'indice è un SQLite a parte; eliminarlo non tocca nemmeno un file.
• Scegli le cartelle (lo decide chi amministra: vale per tutta la casa). Se non ne scegli nessuna, guarda in «Peliculas» e nelle condivise il cui nome sa di videoteca («Series», «Cine»). Le registrazioni delle telecamere non entrano mai.
• Il nome del file è la scheda. Da «Origen (2010).mkv» ricava il titolo e l'anno; da «Serie.S01E02.mkv» o «Serie - 1x02.mkv», la serie, la stagione e l'episodio, e li raggruppa. Di fabbrica non si consulta nulla di esterno, quindi ciò che si vede è ciò che c'è nel file: un nome messo bene fa tutta la differenza.
• Completa da internet (Impostazioni, e lo decide chi amministra). Spento di fabbrica, e spento il NAS non racconta a nessuno quali film hai. Acceso, manda il titolo e l'anno di ogni film e di ogni serie a Wikidata, a Wikipedia e a TVmaze, e porta copertina, trama, generi, data di uscita e i titoli degli episodi. Non esce nient'altro: né percorsi, né nomi di file, né chi guarda cosa.
• Due chiavi facoltative e gratuite. Con quella di themoviedb.org (va bene la «API Key (v3)» o il token v4) le copertine sono migliori e arrivano anche il trailer, il cast e la saga; con quella di omdbapi.com, il voto di IMDb. Senza nessuna funziona comunque, con ciò che danno Wikipedia e TVmaze. Ogni chiave si prova quando la salvi: se il catalogo non la riconosce, non si salva e si dice perché. Le chiavi non escono mai dal NAS e non viaggiano nel backup della configurazione.
• Ciò che è di casa comanda. Se accanto al film c'è un .nfo (quello che lasciano Kodi, Jellyfin e gli organizzatori di videoteche), da lì vengono il titolo e la trama; e se il nome del file o della cartella contiene un identificatore IMDb (tt1375666), la scheda si chiede esatta invece di cercarla per titolo.
• Si completa da sola, poco a poco, dopo ogni ricerca di film; «Completa ora» fa un gruppo lungo senza aspettare. Ciò che nessun catalogo riconosce resta com'è e non si richiede più; ciò che è fallito per la rete si riprova dopo qualche ora.
• «Correggi», nella scheda, abbina a mano: cerca per titolo e anno e mostra le schede candidate con la loro copertina per scegliere quella buona.
• Il trailer si apre fuori, in una scheda nuova: dentro il pannello non si incorpora nessun lettore di terzi.
• «Potrebbe piacerti» e «Per te». Nella scheda di un film o di una serie compare una riga con fino a otto titoli simili, e nella pagina iniziale un'altra a partire dall'ultima cosa che hai visto tu (nessuno vede quella di un altro). Si consiglia solo ciò che È nel NAS e dentro le tue cartelle: non c'è niente da andare a cercare da nessuna parte. Con la chiave di themoviedb.org si usano i suoi consigli e si incrociano con la tua videoteca; senza chiave si confronta per saga, generi e decennio, che è ciò che porta «Completa da internet». Con quella funzione spenta non c'è nulla con cui confrontare e le righe non compaiono. Ciò che è calcolato si conserva una settimana; correggere una scheda a mano lo rifà.
• Avvisare dei nuovi episodi (Impostazioni, sotto «Completa da internet» e dentro di esso: spento quello, questo non chiede nulla). Una volta al giorno si chiede al catalogo, per ogni serie del NAS, quale è stato il suo ultimo episodio trasmesso; se non è qui, arriva un avviso del pannello con la stagione, il numero, il titolo e la data in cui è stato trasmesso. Di ogni episodio si avvisa una sola volta, anche se continua a non esserci. Con la chiave di themoviedb.org si chiede lì; senza nessuna, a TVmaze. Una serie abbinata a Wikidata o a OMDb non dà questo avviso: quei cataloghi non elencano gli episodi con la loro data.
• Copertine: comanda sempre l'immagine accanto (Origen (2010).jpg, poster.jpg, folder.jpg); dopo, quella scaricata dal catalogo; e se non ce n'è nessuna, il NAS estrae un fotogramma al 10 % del film. Un film senza nessuna delle tre si disegna con la sua iniziale: non è un errore.
• Si aggiorna da sola. Guarda se qualcosa è cambiato ogni dieci minuti e fa un passaggio completo ogni ora; «Cerca film» resta per quando non vuoi aspettare.
• Si riproduce nel pannello. Ciò che il browser apre così com'è si serve per intervalli (con i suoi salti); ciò che no —un film con audio Dolby Digital, un MKV su un iPhone— lo converte il NAS al volo, copiando il video quando basta cambiare l'audio. Lo schermo dice quando sta convertendo e perché.
• Qualità: accanto ai sottotitoli, mentre guardi qualcosa. «Originale» è il normale; 1080p, 720p e 480p chiedono al NAS di ridurre l'immagine, che è ciò che serve quando la guardi fuori casa o su un telefono e va a scatti. Compaiono solo le qualità inferiori a quella del film. Si cambia senza perdere il minuto e resta scelta su quel dispositivo per le successive.
• Sottotitoli: i .srt o .vtt che sono accanto al file, con la lingua nel nome se ce l'hanno (Origen (2010).en.srt). Si convertono al volo in ciò che capisce il browser.
• Prenderli da internet. Nella scheda di qualsiasi film c'è un pulsante **«Cerca sottotitoli»**: mostra ciò che c'è nel catalogo per quel titolo nella lingua del pannello e scarica quello che scegli. Il file viene lasciato accanto al film (Origen (2010).it.srt), quindi da quel momento ce l'ha tutta la casa; se in quella cartella non si può scrivere, resta nel NAS e si vede comunque.
• Quelli segnati «Per questo file» sono quelli sincronizzati con la tua copia esatta: il catalogo li ha abbinati tramite un'impronta del file, non per titolo. Gli altri possono essere in anticipo o in ritardo rispetto al tuo montaggio.
• «Sottotitoli automatici» (Impostazioni, sotto «Completa da internet» e spento di fabbrica): con questo acceso, aprendo un film che non ha sottotitoli nella tua lingua il NAS li cerca **una volta** e li lascia impostati. Ciò che non trova non si richiede più da solo; il pulsante per cercare a mano invece riprova sempre quando lo premi.
• Escono da casa il titolo, l'anno e quell'impronta del file; mai il suo percorso né chi lo guarda. La fonte è opensubtitles.org, e funziona senza registrarsi da nessuna parte.
• Account di opensubtitles.com, facoltativo. Senza si cerca e si scarica comunque, con la quota giornaliera condivisa da tutti; con un account gratuito proprio (chiave, utente e password) la quota è tua. Si prova quando lo salvi: se non lo riconoscono, non si salva e si dice perché. Non esce mai dal NAS e non viaggia nel backup della configurazione.
• Riprende da dove l'hai lasciato. Ogni account conserva il suo minuto e nessuno vede quello degli altri; al 95 % il film si considera finito ed esce da «Continua a guardare». In una serie si offre l'episodio successivo.
• «Continua a guardare» anche sul desktop. Con il pulsante «+» del pannello dei riquadri (in alto a destra) si accende il riquadro «Continua a guardare»: fino a sei film o episodi a metà con la loro copertina e dove sono arrivati, e un clic apre l'applicazione su quel film. Si offre solo a chi ha Film e serie.
• Account per bambini. Segnando «Account per bambini» nella scheda di una persona (Pannello di controllo → Utenti e gruppi), quell'account vede qui solo ciò che è classificato come **adatto fino a 12 anni**: il catalogo, le serie, la ricerca, «Continua a guardare» e il lettore. Il filtro lo fa il NAS, non lo schermo, quindi incollargli l'indirizzo di un film non adatto non lo apre comunque. Ciò che non ha classificazione non compare nemmeno, quindi accendi «Completa da internet» —è da lì che arriva— o la sua videoteca resterà quasi vuota. L'applicazione lo dice in una riga, perché non sembri guasta.
• Il confine è quello di sempre: ciò che non puoi aprire in File non compare qui, né il suo nome né la sua copertina.

Applicazioni (Docker)

• Centro pacchetti: installa le ricette di casa (/var/nas/appstore/templates/), che arrivano con ogni versione del NAS: 1058 applicazioni di altri sviluppatori, curate e provate da noi, ciascuna con la sua versione fissa. Non si scarica nessun catalogo di terzi.
• Ricerca, chip di categoria con contatori e filtro «Installate» per muoversi nel catalogo.
• Il pulsante «⟳» di un'app installata scarica l'immagine nuova e ricrea i container.
• L'app Docker mostra i log dal vivo, CPU/RAM e controlla i singoli container. Un container creato a mano (dal terminale, per esempio) che pubblica una porta TCP ha il suo pulsante «Apri» e compare nel Launchpad come un'applicazione in più.

Aggiornare LGM-OS senza reinstallare

Dal pannello: Pannello di controllo → Aggiorna LGM-OS → «Aggiorna ora». Nient'altro. Non serve ripassare la ISO per ogni versione, né avere accesso al codice, né configurare un repository: il NAS chiede al server del produttore qual è l'ultima versione, la scarica e la installa.

Ciò che succede dentro, nel caso un giorno serva guardarlo:

1. Il NAS chiede l'ultima versione pubblicata e la confronta con la sua. Confronta numeri, non testo: la 1.10.0 è successiva alla 1.9.0.
2. Scarica il pacchetto e verifica il suo SHA-256 con quello che ha annunciato il server. Se non coincide, non installa nulla e lo dice con queste parole: ciò che è arrivato non è ciò che il server aveva detto che sarebbe arrivato, che è molto diverso da «il download è fallito».
3. Applica l'aggiornamento con la stessa procedura di sempre: compila, convalida e solo allora promuove. Se dopo il pannello non risponde, torna indietro da solo alla versione precedente.

Dalla console: sudo lgm update.

Opzioni

• Automatico: «Cerca automaticamente gli aggiornamenti» avvisa in Notifiche quando c'è una versione nuova; «Installali senza chiedere» li applica da soli ogni 6/12/24 ore o ogni 7 giorni, e solo dentro la fascia che scegli (di fabbrica, dalle 03:00 alle 06:00): l'aggiornamento riavvia i servizi e i registratori delle telecamere, e di notte non disturba nessuno. Fuori dalla fascia l'avviso arriva comunque.
• Dal tuo codice (solo se hai clonato il repository): se il dispositivo ha un checkout git con remoto, il pannello lo usa invece del server delle versioni. È la strada di chi sviluppa; per un NAS installato dalla ISO non serve niente di tutto questo.

Cosa racconta il NAS al sito

Ogni dodici ore il NAS chiede al server delle versioni se la sua licenza —o la sua prova— è ancora valida, e nella stessa chiamata gli dice come si chiama, quale versione ha, quanto spazio gli resta e se ha avvisi in sospeso: è ciò che vedi nella scheda del tuo NAS nel tuo account sul sito. Viaggiano anche l'impronta del certificato del pannello e i suoi indirizzi dentro la tua rete di casa, che è ciò con cui l'app LGM Connect trova il NAS senza uscire su internet.

Con quello stesso messaggio viaggiano i dati tecnici del dispositivo, per poterti aiutare se qualcosa si guasta: produttore e modello della scheda madre, processore, memoria, i dischi (modello, dimensione, tipo e stato di salute), come sono montati i volumi, il tipo di schede di rete e grafiche, e quante app, macchine virtuali e telecamere ci sono. Senza numeri di serie, senza indirizzi di rete e senza nulla di tuo dentro (né nomi di file, né account). Si spengono in Pannello di controllo → Licenza → Dati tecnici e assistenza, e Vedi cosa si invia —in «Qualcosa è andato storto?»— mostra esattamente ciò che esce. Le versioni nuove arrivano a ondate: a ogni dispositivo tocca in un giorno diverso dei primi, e «Installa comunque» la mette prima che tocchi a lui.

Mentre aggiorna

Vedrai una barra con la fase e una percentuale approssimativa —backup, pacchetti di sistema, preparare l'interfaccia, backend, riavviare i servizi—. Il passaggio lungo è installare i pacchetti di sistema: può richiedere diversi minuti senza dare segni, ed è normale. L'interfaccia arriva già pronta e si colloca in pochi secondi. Il pannello si riavvia a metà: la barra lo dice e continua a contare appena torna.

Alla fine, l'aggiornamento verifica che tutto ciò che era acceso sia ancora acceso (Docker, Samba, libvirt, NFS…) e, se qualcosa è rimasto fermo, lo avvia e lo dice per nome. Anche se l'aggiornamento fallisce: una versione che si arrende a metà non può lasciarti senza container né senza cartelle della casa.

Se fallisce

L'avviso rosso porta le ultime righe del registro —che è dove c'è l'errore— e un menu a tendina con il registro completo. Dalla console:

sudo tail -n 40 /var/log/lgm-update.log

Siccome l'aggiornamento torna indietro da solo, il NAS resta funzionante con la versione precedente: non c'è fretta di sistemarlo. La causa abituale è restare senza spazio nel disco di sistema, e il pannello lo dice con queste parole.

Verifica dei servizi

Pannello di controllo → Verifica del sistema controlla uno per uno il pannello, l'archiviazione, SMB, NFS, WebDAV, SSH, Docker, i backup e le telecamere. Non guarda ciò che il pannello ha salvato che dovrebbe succedere: guarda il sistema —se l'unità di systemd è viva, se c'è qualcosa in ascolto sulla porta, se il firewall lo lascia passare, se la configurazione coincide con ciò che è stato chiesto— e ogni problema arriva con cosa fare.

È la prima cosa da aprire quando qualcosa «non va» da un altro dispositivo: dice se il guasto è nel NAS o fuori, che è metà del lavoro.

Monitor delle risorse

Cosa ha fatto il NAS mentre non guardavi. L'app Monitor conserva l'uso di processore, memoria, disco e rete e lo disegna in quattro grafici, con l'intervallo da scegliere: ultima ora, giorno, settimana o mese.

Serve a rispondere alle tre domande a cui un numero istantaneo non risponde:

• «È lento… da quando?» — un gradino nel grafico della CPU o della memoria dice il giorno e quasi l'ora in cui è cominciato, che di solito coincide con un'applicazione installata o con un backup nuovo.
• «Resta senza memoria?» — un soffitto piatto al 100 % per ore è questo; picchi isolati copiando file sono normali.
• «Sfrutto la rete?» — il grafico della rete durante una copia grande dice se il collo di bottiglia è il disco o il cavo.

La cronologia la scrive il NAS stesso ogni pochi minuti e occupa pochissimo: non serve accendere nulla, è già in funzione. Reinstallando o distruggendo il volume si ricomincia da zero, perché è storia, non dati.

Il desktop

Tutto il pannello vive su un desktop con finestre, uguale nel browser e in LGM Connect.

Desktop virtuali e centro di controllo

• Ci sono tre desktop, ognuno con le sue finestre. Si cambia con Ctrl+Alt+← / →, scorrendo due dita di lato sullo sfondo o dai desktop nell'area di sistema del dock. Per portare una finestra su un altro, clic destro sulla sua barra del titolo → «Sposta su un altro desktop». Quando ricarichi, ogni finestra torna al suo desktop.
• Ctrl+Spazio apre il Centro di controllo: tutte le app e le impostazioni che il tuo account può aprire, in ordine, e le impostazioni di questo dispositivo, con il testo grande a portata di mano.

Il clic destro e la pressione prolungata

• Il clic destro apre un menu ovunque: lo sfondo, la barra in alto, le finestre, i widget, il dock, Applicazioni e dentro ogni app. Nei campi di testo continua a comparire quello del browser, per copiare e incollare.
• I menu hanno sottomenu e mostrano le loro scorciatoie, e si usano con le frecce, Invio ed Esc.
• Sullo sfondo ci sono «Aggiorna il desktop» e «Impostazioni rapide» (tema, widget e barra). Sulla barra del titolo di una finestra: ridurre a icona, ingrandire, agganciare a metà schermo, cambiare desktop o chiudere. Su un'app in Applicazioni: aprirla, metterla sul desktop o fissarla nella barra.
• Sul telefono, tieni premuto il dito mezzo secondo in qualsiasi punto: compare lo stesso menu, e confermare dà una piccola vibrazione.

Il dock e i widget

• Di serie il dock porta le app di tutti i giorni che il tuo account può aprire, e quelle aperte alla fine, dopo una riga. Un punto segna l'app aperta, un fumetto i suoi avvisi non letti, e l'icona mostra l'avanzamento delle sue attività. Se l'avevi già sistemato a modo tuo, resta com'era.
• Ha tre modi, nel suo clic destro → «Configura la barra»: «Sempre visibile», «Nascondersi da sola» e «Fluttuante compatta».
• Alla fine del dock c'è l'area di sistema: i desktop, la rete del NAS, spegnere o riavviare e «Il tuo account», dove ci sono i tuoi dati ed «Esci».
• Ogni widget sceglie la sua dimensione — «Piccolo (mezza riga)», «Largo (riga intera)» o «Grande» — dal suo menu «⋯» o con il clic destro, che serve anche a ridurlo, configurarlo, duplicarlo o toglierlo. Si salva con il tuo account, quindi ti segue su un altro dispositivo.

IA locale

L'app IA locale risponde dal NAS stesso, senza mandare niente fuori. Chi amministra il NAS la accende e sceglie il modello; poi la concede in Pannello di controllo → Utenti e gruppi come qualsiasi altra app (di serie nessun altro ce l'ha).

• Ogni account, la sua. Ogni persona con il permesso la usa con le sue cartelle e i suoi documenti: riassumerli, lasciare un foglio di calcolo nella sua cartella, sistemare il suo desktop. Quello che dice ogni account, e quello che l'IA ricorda di lui, lo vede solo lui, nemmeno chi amministra.
• Conversazioni salvate. In «Conversazioni» ce ne sono diverse, con un nome, salvate sul NAS: restano lì anche se chiudi la finestra o ricarichi. «Inizia un'altra conversazione» ne apre una nuova.
• Usa il pannello con i tuoi permessi. Cerca l'azione, ti lascia il pulsante per andare alla schermata e, se qualcosa cambierebbe il NAS, ti mostra prima cosa farà e aspetta che premi «Approva». Non può mai più di te, e quello che legge in un documento lo prende come dato, non come ordine. «Ferma» la interrompe subito. A chi amministra può inoltre installare un'app dal Centro pacchetti o misurare la velocità dei dischi, sempre con approvazione.
• Lo stato del NAS. Chiedile come sta il NAS e risponde con la scheda **«Come sta il NAS adesso»**: un verdetto — Bene, Attenzione o Grave — con i suoi numeri (dischi, temperature, rete, scheda grafica) e la guida da cui viene ogni passo; ogni citazione apre la sua guida. Quando si apre suggerisce cosa conviene controllare: un disco caldo, un backup fallito, un volume quasi pieno.
• «Chiedi all’IA», nel clic destro di un container, un disco, un file, un avviso o un widget, le chiede di quella cosa senza doverla spiegare.
• «Spiegamelo in modo semplice», sotto ogni risposta accanto a copiare e chiedere di nuovo, la ripete senza parole tecniche.

La scheda Grafica

La vecchia app Grafica e IA ora è la scheda Grafica dell'IA locale, e la vede solo chi amministra: ogni scheda grafica e dispositivo di IA del NAS, quanto si usa e quali applicazioni la tengono. Se avevi un collegamento alla vecchia app, non c'è più: apri IA locale → Grafica.

Terminale web

Shell vera nel browser, solo per amministratori. Parte come l'utente del servizio (nas, senza privilegi), e il pulsante «Sessione root» apre una shell di amministratore. Entrambe —e anche la console di un container, in Docker— chiedono prima di confermare la password e il codice del secondo fattore se lo hai attivo (o una passkey): il permesso è un token monouso che scade in 60 secondi e apre solo la console per cui è stato chiesto. La sessione root la crea l'aiutante privilegiato (il servizio del pannello gira con NoNewPrivileges=yes, dove sudo non può funzionare) e ogni apertura resta nel registro di controllo. Da lì puoi installare ciò che vuoi (docker run …, apt install …); se ciò che lanci pubblica una porta web, comparirà in Docker e nel Launchpad.

Licenza e prova

C’è una licenza Home (pagamento unico, con un anno di aggiornamenti che si estende di anno in anno), una A vita (aggiornamenti per sempre) e l’Business (mensile, annuale o a vita). Tutto si fa in Pannello di controllo → Licenza, che mostra anche il conto alla rovescia degli aggiornamenti che restano.

• Quando finiscono gli aggiornamenti, il NAS continua a funzionare per intero: solo non installa le versioni pubblicate dopo. Aggiorna LGM-OS lo dice e porta a lgm-os.com per aggiungere un anno o passare alla licenza a vita; la licenza estesa arriva da sola al NAS in poche ore.
• Se un abbonamento Business viene annullato, finito il periodo pagato il NAS continua come Domestico: le funzioni aziendali si spengono e non si cancella nulla.
• Collegare il tuo account. Premi Collega il mio account: il pannello mostra un codice e un indirizzo di lgm-os.com. Aprilo da qualsiasi dispositivo —va bene il telefono—, accedi con il tuo account gratuito e scegli cosa fare con quel NAS: cominciare la prova o **usare una tua licenza**. Il pannello se ne accorge da solo in pochi secondi; non bisogna copiare nessuna chiave.
• La prova dura 60 giorni e apre tutto tranne l'indirizzo di LGM Tunnel, che è della licenza. È una per dispositivo e dell'account che l'ha cominciata: reinstallare prosegue la stessa prova, con la stessa data di fine.
• Un NAS appena installato ha 7 giorni per collegarsi. Fino ad allora funziona per intero e il pannello te lo ricorda.
• Se hai diverse licenze, collegando scegli quale va su quel dispositivo e le dai un nome («Casa», «Ufficio») per distinguerle nel tuo account.
• Con una licenza acquistata non serve collegare nulla: Ho una chiave → Incolla una chiave continua a funzionare come sempre.

Quando la prova finisce: «solo dati»

Senza licenza, alla fine della prova —o dei 7 giorni senza collegarsi— il NAS passa a solo dati. I tuoi dati non vengono mai trattenuti:

• Continua a funzionare ciò che serve per portarli via: entrare nel pannello, **vedere e scaricare tutti i tuoi file, le cartelle della casa in sola lettura** dai tuoi dispositivi, lo stato dei dischi e i loro avvisi, aggiornare il sistema, spegnere e riavviare.
• Si mette in pausa tutto il resto: le app e le macchine virtuali si fermano, le telecamere smettono di registrare e i backup e le attività pianificate non girano. La VPN e il nome di casa continuano a funzionare: se sei fuori, puoi entrare a prendere i tuoi file e ad attivare la licenza.
• Non si elimina nulla. Attivando una licenza, ciò che era in funzione riparte così come l'avevi lasciato.

Qualcosa è andato storto?

Qualcosa è andato storto? è nella barra in alto del desktop —sul telefono, la prima cosa del centro di controllo— e in Pannello di controllo → Licenza. Manda un rapporto all'assistenza: ciò che scrivi, la versione e l'app che dava problemi. Se lasci spuntata la casella, accompagna i dati tecnici del dispositivo e le ultime righe di errore del pannello, da cui il NAS toglie prima password, indirizzi con credenziali, email e percorsi di cartelle personali. Nessuno entra nel tuo NAS: il rapporto è l'unica cosa che esce.

Sistema

• Nome del dispositivo: quello che hai scelto durante l'installazione si cambia in **Pannello di controllo → Informazioni sul dispositivo, con il pulsante Cambia** che c'è accanto al nome. Solo lettere minuscole, numeri e trattini (da 1 a 63, senza cominciare né finire con un trattino): è un nome di macchina, non un titolo. È l'indirizzo da cui si entra nel NAS (https://<nome>.local:5001), quindi cambiandolo bisogna aggiornare i preferiti di tutta la casa. Il NAS si riannuncia da solo in rete (il Finder del Mac e «Rete» di Windows); il certificato del pannello contiene il nome e si rifà al riavvio successivo, quindi fino ad allora il browser avvisa entrando con il nome nuovo.
• Rete: IP statico/DHCP per interfaccia tramite systemd-networkd. ⚠️ Un errore qui può lasciare il NAS irraggiungibile; tieni a portata di mano la console fisica.
• Ora: il fuso orario e la sincronizzazione NTP sono in **Pannello di controllo → Regione e lingua. Sotto, Server dell'ora** permette di scrivere i tuoi, uno per riga (pool.ntp.org, o l'indirizzo del router, che quasi sempre dà l'ora). Vuoto = quelli del sistema, che è la cosa normale; si cambiano quando la rete non ha uscita su internet o ha chiusa la porta 123/UDP, perché con l'orologio sbagliato i certificati scadono prima del tempo e le attività pianificate scattano all'ora sbagliata.
• Schermo del server (modalità chiosco): se il dispositivo ha un monitor collegato (o la console della sua macchina virtuale), si avvia mostrando questo stesso pannello a schermo intero, come qualsiasi altro sistema operativo, e si continua ad amministrare dal web dal resto della rete come prima. Si installa solo quando c'è uno schermo e si spegne con un interruttore in Pannello di controllo → Informazioni sul dispositivo.

La console non sparisce mai: il pannello occupa il terminale 7 e l'accesso di sempre resta nell'1. Se lo schermo si rompe —X non si avvia, il browser si chiude, il pannello non risponde— con Ctrl+Alt+F1 hai una console vera, e Ctrl+Alt+F7 torna al pannello. Dalla console, lgm kiosk off la spegne, lgm kiosk log dice perché fallisce e lgm kiosk on la riaccende.

• Aggiornamenti del sistema operativo: non si fanno dal pannello. Un apt upgrade non presidiato può riavviare servizi o lasciarli a metà senza nessuno davanti; chi vuole aggiornare Debian ha il terminale. Ciò che invece si aggiorna dal pannello è LGM-OS, che è codice proprio e sa riavviarsi da solo.
• Backup della configurazione: download occasionale o attività pianificata di tipo «backup» verso un pool. Contiene tutto lo stato del pannello (utenti, gruppi, cartelle della casa con i loro permessi, servizi, firewall, rete, attività…) tranne i segreti del dispositivo, che si rigenerano. Non include i tuoi dati (per quelli, l'app Backup); conservalo dentro il backup esterno, perché è la prima cosa che ti servirà quando ricostruisci il dispositivo. Dettagli e ripristino in disaster-recovery.md.
• Registri: journald per unità; Controllo: chi ha fatto cosa e da quale IP.
• Mandare i registri a un altro dispositivo (syslog): Pannello di controllo → Centro registri → Manda i registri a un altro dispositivo. Manda una copia di tutto ciò che il NAS lascia scritto a un server di registri della tua rete (dispositivo, porta —514 di default— e UDP o TCP). Serve ad avere tutto insieme e, soprattutto, perché la traccia resti fuori dal NAS se qualcuno ci entra. Al salvataggio si prova la destinazione: con TCP la risposta è vera, e con UDP si verifica solo che il dispositivo esista in rete, perché nessuno conferma un datagramma. Lo fa rsyslog, che LGM-OS installa e lascia spento finché non accendi questo; in un NAS installato prima della 1.65 può mancare e la schermata ti dice come metterlo.

Ripristino delle impostazioni di fabbrica

Pannello di controllo → Ripristino delle impostazioni di fabbrica lascia il pannello come il primo giorno senza reinstallare né toccare i dischi: per quando il NAS cambia mano o preferisci ricominciare la configurazione da zero. Lo vede solo chi amministra.

Come si conferma. Servono tre cose: la tua password, il codice a due passaggi se il tuo account ce l'ha e un codice di otto lettere e numeri che compare solo sullo schermo collegato al NAS. Premi Chiedi il codice e guardalo lì (se quello schermo mostra il pannello, premi Ctrl+Alt+F1). Scade dopo dieci minuti, ammette tre tentativi e bisogna scriverlo a mano, perché è ciò che dimostra che hai il NAS davanti. Senza uno schermo collegato non si può: collegane uno. Nemmeno mentre è in corso qualcosa che sposta dati —un backup, un ripristino, un cambio di disco— o un aggiornamento: la schermata dice cos'è e di aspettare.

Cosa succede dopo. Prima di eliminare qualsiasi cosa, il NAS salva una copia delle impostazioni attuali nel suo disco di sistema, in /var/nas/apartados/fabrica-<data>. Alla fine si riavvia il pannello e ti chiede di creare l'account di amministratore, come il primo giorno, con il codice di registrazione dello schermo del NAS. Il primo avviso dice dove è finita quella copia e, se qualcosa non si è potuto togliere, cos'è e cosa farne. Dal pannello non si può annullare.

I tuoi dati restano nei volumi: se il NAS lascia casa e vuoi eliminare anche quelli, elimina il pool in Archiviazione.

Sicurezza

• Architettura a due processi: l'API gira come utente nas senza privilegi e delega a nas-helper (root) attraverso un socket Unix; l'aiutante accetta solo un elenco chiuso di comandi e percorsi (backend/app/core/allowlist.py).
• TLS: autofirmato generato al primo avvio, con gli indirizzi del dispositivo dentro e con validità di 396 giorni —sotto il limite di 398 che accettano iOS e iPadOS; con di più, un iPhone **non lascia entrare** nel pannello nemmeno con l'avviso—. Si controlla a ogni avvio e si rifà solo se sta per scadere o se il NAS cambia IP; il tuo o quello di Let's Encrypt non si toccano. La cosa normale è sostituirlo con uno di Let's Encrypt quando si pubblica il NAS (vedi Accesso da internet); per metterne uno tuo a mano: ```bash cp tucert.pem /etc/nas/tls/cert.pem && cp tuclave.pem /etc/nas/tls/key.pem chgrp nas /etc/nas/tls/key.pem && chmod 640 /etc/nas/tls/key.pem systemctl restart nas-backend ```
• Protezione dell'accesso: 10 tentativi/minuto per IP; 5 errori di seguito bloccano l'account per 5 minuti. Tutto resta nel registro di controllo.
• Durata della sessione: di fabbrica il pannello si chiude da solo dopo 30 minuti senza usarlo, e si cambia in Pannello di controllo → Sicurezza → Regole della password → **Durata della sessione** (da 5 a 1440 minuti). Non è un termine rigido: ogni cosa che fai allunga la sessione, quindi lavorando non si interrompe mai e ciò che scade è un pannello aperto e dimenticato. Chi spunta «mantieni l'accesso» quando entra resta con 30 giorni, e le sessioni già aperte durano quanto è stato loro dato: il termine nuovo vale dall'accesso successivo.
• Ruoli: admin (totale) e viewer (sola lettura), gestiti in Sicurezza.
• Non aprire mai la porta 5001 nel router: serve il pannello con certificato autofirmato ed espone l'API di amministrazione senza nulla davanti. Non serve più quel ripiego, perché ci sono due modi migliori di arrivare da fuori e il NAS li ha entrambi: la VPN —WireGuard, o Tailscale e NetBird— (non pubblica nessun servizio su internet) o l'accesso esterno con Apache su 80/443 e un certificato valido di Let's Encrypt. Le due sezioni seguenti.

Accesso da internet

Pannello di controllo → Accesso esterno: dominio dinamico (DDNS), certificato Let's Encrypt e proxy inverso per pubblicare il pannello e le app per sottodominio. Apache resta l'unico servizio esposto (80 e 443) e inoltra a 127.0.0.1; la porta 5001 e quelle delle app non escono dal NAS. Con un certificato valido, inoltre, l'interfaccia si può installare come applicazione (PWA).

La procedura completa —porte del router, DuckDNS passo passo, emissione e rinnovo del certificato, sottodomini e l'elenco di sicurezza preliminare (2FA, Consulente di sicurezza, blocco degli IP)— è in external-access.md. Alternativa più prudente se non devi condividere con terzi: la VPN del NAS stesso (sezione seguente), senza esporre nessun servizio.

Servizi di rete (VPN, DNS e DHCP)

Pannello di controllo → VPN, DNS e DHCP. I tre pezzi che trasformano il NAS nel centro della rete di casa, ordinati per rischio:

• La VPN è il modo più sicuro di arrivare al NAS da fuori: non pubblica nessun servizio su internet e dà accesso a tutta la rete locale, non solo al pannello.
• Tailscale e NetBird si installano dalla stessa schermata, nelle loro schede, e sono la strada quando non puoi aprire porte (CGNAT). Ciò che entra da loro conta come di casa nel firewall.
• Il DNS e il DHCP sono lo stesso servizio (dnsmasq), quindi fermarlo ferma entrambi: è proprio ciò che serve in un'emergenza (sudo systemctl stop dnsmasq).
• dnsmasq si installa disattivato e si avvia solo quando attivi DNS o DHCP dal pannello.

Porte del router, installazione del client VPN passo passo, come puntare i dispositivi al DNS e —la cosa più importante— come recuperare la rete se il DHCP ti lascia senza connessione: network-services.md. Leggila prima di attivare il DHCP, e salvala sul telefono: se resti senza rete, non potrai consultarla dal NAS.

Pubblicare app nel catalogo

Ogni app è una directory /var/nas/appstore/templates/<id>/ con:

• manifest.json — id, nome, descrizione, images (pre-scaricate con avanzamento), web_port ed env (variabili che il programma di installazione chiede all'utente; secret le nasconde).
• docker-compose.yml — consuma quelle variabili più NAS_APP_DATA (percorso dei dati che inietta il backend).

Installare richiede un pool: i dati di ogni app vivono in <pool>/docker/<id>/ (le installazioni precedenti a questa politica restano in /var/nas/apps/ e non si spostano). Quella cartella docker non è una cartella della casa —il gestore di file e SMB/NFS non la mostrano— e il suo nome è riservato quando si creano cartelle della casa. Ogni porta che l'app pubblica (e, se condivide la rete del NAS, quelle che dichiara la sua ricetta) riceve all'installazione una regola nel firewall con il nome dell'app, aperta alla rete di casa. In Sicurezza → Firewall si chiude o si apre a qualsiasi origine; quella scelta torna se si reinstalla, e la regola si ritira disinstallando.

Per un repository remoto serve via https un index.json:

{
  "apps": [
    {
      "id": "jellyfin",
      "manifest_url": "https://repo.example.com/jellyfin/manifest.json",
      "compose_url": "https://repo.example.com/jellyfin/docker-compose.yml",
      "sha256_manifest": "<sha256>",
      "sha256_compose": "<sha256>"
    }
  ]
}

Console della flotta

Edizione Business. L'app Flotta mostra a colpo d'occhio tutti i LGM-OS dell'azienda: se stanno bene, gli avvisi non letti, dischi e volumi, capacità, ultima copia riuscita e versione, con l'aggiornamento in sospeso. Parla con ogni NAS attraverso il suo solito pannello cifrato (5001): non apre nessuna porta nuova. Un NAS che non risponde compare con il suo motivo e con gli ultimi dati noti, senza rallentare gli altri.

Aggiungere un NAS. Sul NAS che vuoi vedere, apri Flotta → Questo NAS e crea una chiave: Solo vedere (legge il suo riepilogo e nient'altro) o Vedere e aggiornare (in più può avviare il suo aggiornamento). Nella console, premi «Aggiungi un NAS», scrivi il suo indirizzo e incolla la chiave. Prima di inviarla, la console mostra l'impronta del certificato di quel NAS: confrontala con quella in Flotta → Questo NAS e, se non è la stessa, non andare avanti.

Un certificato che cambia. Da quel momento la console parla con quel NAS solo se il suo certificato è firmato dalla stessa autorità: il rinnovo annuale non dà l'allarme, ma un NAS reinstallato (o qualcuno che si spaccia per lui) compare come «Certificato cambiato» e non riceve la chiave. Dopo averlo reinstallato, «Confronta di nuovo l'impronta».

Aggiornare in gruppo. Spunta «Includi nell'aggiornamento» sui NAS che vuoi e premi «Aggiorna i selezionati». Si aggiornano uno alla volta, nell'ordine della lista, e se uno non riesce ci si ferma lì: gli altri restano come erano.

Le chiavi. Le chiavi degli altri NAS si conservano a parte, fuori dalla copia della configurazione, e il pannello non le mostra più. Se ripristini la configurazione su un altro dispositivo, aggiungi di nuovo ogni NAS. Perché una console smetta di vedere un NAS, revoca la sua chiave su quel NAS (Flotta → Questo NAS).