Cos'è xTeve?

xTeve è un proxy M3U che emula un hardware HDHomeRun. Questo permette a Plex di "vedere" una lista IPTV come se fosse un sintonizzatore fisico collegato alla rete, abilitando funzionalità come la Guida TV (EPG) e la registrazione (DVR).

Disclaimer: Questa guida è redatta a solo scopo illustrativo per usi privati e legali. L'autore e il forum non si assumono alcuna responsabilità per utilizzi illeciti derivanti dall'uso di questo software.

1. Requisiti Preliminari

Prima di iniziare, assicuratevi di avere:

• Plex Media Server installato e funzionante.

• Una lista canali in formato M3U (nell'esempio useremo Pluto TV).

• Un file/link XMLTV (per l'EPG - la guida programmi).

• Plex Pass (necessario per la funzione Live TV/DVR di Plex).

2. Installazione del Docker

1. Andate nel tab APPS del vostro server Unraid.

2. Cercate xTeve.

   • Nota: Se volete offuscare il traffico, potete usare la versione xTeve_VPN, come nel mio caso (la configurazione di base però non cambia).

     

3. Configurazione parametri Docker:

   • Network Type: Impostate tassativamente su Host (necessario affinché Plex lo rilevi automaticamente).

   • Temp Directory: Create o assegnate una cartella specifica.

     • Consiglio: Puntate la directory sulla Cache (M.2/SSD) per eliminare i colli di bottiglia durante il buffering.

• VPN (Opzionale): Se usate la versione VPN, inserite le credenziali del vostro provider.

• Local Network: Inserite la struttura della vostra sottorete LAN (es. 192.168.1.0/24 o 192.168.178.0/24). È l'IP che usate per accedere a Unraid, ma terminante con .0/24.

Controllate che le porte non siano in conflitto con altri servizi e cliccate su Apply.

3. Configurazione di xTeve (Web UI)

Aprite l'interfaccia web di xTeve (solitamente IP-DEL-SERVER:34400/web). Al primo avvio partirà un wizard:

1. Tuner: Inserite il numero di stream simultanei consentiti dal vostro provider. Se usate Pluto TV o liste libere, inserite un numero congruo ai vostri utenti (es. 5).

2. EPG Source: Selezionate XMLTV.

3. M3U Playlist URL: Inserite il link della vostra lista.

   • Esempio Pluto TV: https://raw.githubusercontent.com/Brenders/Pluto-TV-Italia-M3U/main/PlutoItaly.m3u

4. XMLTV URL: Inserite il link per la guida programmi.

   • Esempio Pluto TV: https://raw.githubusercontent.com/matthuisman/i.mjh.nz/master/PlutoTV/it.xml
     Ottimizzazione Streaming (Fondamentale)

     Una volta terminato il wizard, andate in Settings per garantire la massima stabilità:

   • Streaming > Stream Buffer: Impostate su FFmpeg.
     

1. Buffer Size: 1MB (standard) o 5MB se avete una connessione meno stabile.

2. FFmpeg Options: Sovrascrivete la riga esistente con questa configurazione ottimizzata:

   -hide_banner -loglevel error -i [URL] -c:a libmp3lame -vcodec copy -f mpegts pipe:1

le impostazioni dovrebbero essere come nell'immagine:

Prossimi Passi

Ora che xTeve è configurato e i canali sono "mappati", il server è pronto per essere aggiunto a Plex.

Fate SAVE, chiudete il docker e riavviatelo.

Configurazione Su Plex Media Server

Dopo aver configurato correttamente xTeve, il gioco è quasi fatto. Ora dobbiamo dire a Plex di leggere xTeve come se fosse un sintonizzatore fisico.

1. Preparazione degli URL in xTeve

Prima di spostarci su Plex, assicuratevi di avere sottomano i due indirizzi fondamentali che xTeve ha generato per voi. Li trovate nella schermata principale (Dashboard) di xTeve:

• DVR IP: (es. http://192.168.1.100:34400)

• XEPG URL: (il link che finisce con .xml, serve per la guida programmi).

2. Aggiungere il sintonizzatore su Plex

1. Aprite Plex, andate in Impostazioni (l'icona della chiave inglese in alto a destra).

2. Nella colonna di sinistra, scorrete verso il basso fino alla sezione Gestisci e cliccate su Live TV & DVR.

3. Cliccate sul pulsante Configura il DVR di Plex (o "Aggiungi un dispositivo").

4. Plex inizierà la scansione. Se xTeve è impostato correttamente su rete HOST, dovrebbe apparire automaticamente.

   • Se non appare: Cliccate su "Inserisci l'indirizzo IP manualmente" e digitate l'indirizzo di xTeve (es. 192.168.1.100:34400).

5. Una volta trovato, cliccate su Continua.

3. Configurazione Canali e Guida (EPG)

Qui è dove colleghiamo i programmi ai canali:

1. Plex vi mostrerà l'elenco dei canali trovati. Cliccate su Continua.

2. Nella schermata successiva, Plex vi chiederà la nazione e il codice postale per la guida programmi. NON usate quella di Plex.

3. Cliccate invece sulla scritta arancione in alto: "Hai un file XMLTV sul tuo computer?".

4. Nel campo Guida XMLTV, incollate l'indirizzo XEPG URL che avete copiato prima da xTeve.

5. Date un nome alla guida (es. "Pluto TV xTeve") e premete Continua.

4. Mapping dei Canali

Plex caricherà la lista. Ora dovete assicurarvi che il nome del canale a sinistra corrisponda al programma corretto a destra.

• Se avete fatto tutto bene in xTeve, Plex dovrebbe accoppiarli automaticamente.

• Se vedete dei canali "non mappati", selezionateli manualmente dal menu a tendina.

• Cliccate su Continua e poi su Fine.

5. Consigli Post-Configurazione

Plex inizierà a scaricare i dati della guida (potrebbe volerci qualche minuto). Una volta terminato:

• Aggiornamento Guida: Di default Plex aggiorna la guida ogni poche ore. Potete forzarlo andando in Impostazioni > Live TV & DVR e cliccando sui tre puntini accanto al dispositivo, selezionando "Aggiorna Guida".

• Qualità Streaming: Poiché abbiamo impostato il buffer su FFmpeg nella Parte 1, Plex riceverà un flusso già ottimizzato. Se notate scatti, tornate in xTeve e aumentate il buffer a 5MB.

• Transcodifica: Se volete registrare i programmi, ricordate che Plex salverà il file così come arriva. Assicuratevi di avere abbastanza spazio sul disco configurato per le registrazioni.

Ora, andando nella sezione Live TV del vostro client Plex (TV, Smartphone o Web), troverete la griglia programmi completa. Potete cambiare canale, guardare cosa c'è in onda e persino programmare registrazioni come se aveste un decoder di ultima generazione!

Trucco Extra: Se aggiungete o rimuovete canali in xTeve in futuro, ricordatevi sempre di fare un "Update" sia su xTeve che sulla Guida di Plex per vedere le modifiche.

Buona visione a tutti su Unraid Italia!

PS. Liste ITA/ENG libere e gratuite con i suoi epg:

M3u

Pluto TV:

https://raw.githubusercontent.com/Brenders/Pluto-TV-Italia-M3U/main/PlutoItaly.m3u

Samsung TV:

https://tinyurl.com/multiservice21?region=it&service=SamsungTVPlus

Roku TV:

https://tinyurl.com/multiservice21?region=it&service=Roku

PBS:

https://tinyurl.com/multiservice21?region=it&service=PBS

https://tinyurl.com/multiservice21?region=it&service=PBSKids

Stirr:

https://tinyurl.com/multiservice21?region=it&service=Stirr

Tubi:

https://raw.githubusercontent.com/BuddyChewChew/tubi-scraper/refs/heads/main/tubi_playlist.m3u

EPG:

Pluto TV:

https://raw.githubusercontent.com/matthuisman/i.mjh.nz/master/PlutoTV/it.xml

Samsung TV:

https://github.com/matthuisman/i.mjh.nz/raw/master/SamsungTVPlus/it.xml.gz

Roku TV:

https://github.com/matthuisman/i.mjh.nz/raw/master/Roku/all.xml.gz

PBS:

https://i.mjh.nz/PBS/all.xml.gz

https://github.com/matthuisman/i.mjh.nz/raw/master/PBS/kids_all.xml.gz

Stirr:

https://i.mjh.nz/Stirr/all.xml.gz

Tubi:

https://github.com/dtankdempse/tubi-m3u/raw/refs/heads/main/tubi_epg_us.xml

testate i link 1 per volta perchè xTeve supporta massimo 500 canali (a quanto so) quindi inserite quello che ritenete più interessante per le vostre esigenze

AGGIORNAMENTO 23/04/2026

se non trovate xteve perchè vi da outdated, usate Threadfin che è identico ma più recente

Perché utilizzare PlexCache-D?

Il vantaggio principale è la fluidità di lettura. Spostando i file su SSD/NVMe, eliminiamo i tempi di spin-up dei dischi rigidi e i colli di bottiglia, fattore cruciale soprattutto per file ad alto bitrate come i Remux 4K HDR.

⚠️ Disclaimer

ATTENZIONE: Né l'autore di questa guida, né Unraid Italia, né gli sviluppatori del tool si assumono la responsabilità per l'eventuale perdita di dati o corruzione delle librerie. Sebbene il tool sia testato, operate con cognizione di causa. Eseguite sempre un backup della vostra configurazione e dei database prima di procedere.

Prerequisiti Hardware

Per ottenere le massime prestazioni, è consigliabile utilizzare un drive NVMe/SSD dedicato (anche un taglio da 500GB o 1TB è sufficiente). Se non disponete di hardware extra, potete tranquillamente utilizzare il vostro Cache Pool esistente, allocando una cartella specifica per lo scopo.

STEP 1: Preparazione dell'Hardware (Opzionale)

Segui questo passaggio solo se hai aggiunto un nuovo disco fisico. Se intendi usare la cache attuale, passa direttamente allo Step 2.

1. Spegni il server e installa il nuovo drive (es. M.2 NVMe).

2. Accendi il server e vai nella sezione MAIN.

3. Esegui lo STOP dell'Array.

4. Clicca su ADD POOL, assegna un nome (consigliato: plex_cache) e seleziona il nuovo disco.

5. Avvia l'Array e formatta il nuovo drive (il file system ZFS è caldamente consigliato per la gestione dei dataset e la velocità).

STEP 2: Configurazione della Share su Unraid

Dobbiamo creare il "contenitore" dove PlexCache-D andrà a spostare i file temporaneamente.

1. Vai nel tab SHARES e clicca su ADD SHARE.

2. Nome Share: plex_cache.

3. Primary Storage: Seleziona il pool creato nello step precedente (o il tuo pool cache principale).

4. Secondary Storage: Imposta su None (vogliamo che questi file restino tassativamente sull'SSD per massimizzare le performance).

5. Export: No (non è necessario vederla in rete SMB).

STEP 3: Installazione manuale del Docker

siccome non è presente su CA Apps il docker, dobbiamo installarlo manualmente:

1. scaricate qui la struttura del docker plexcache-d.xml

2. inseritela qui /boot/config/plugins/dockerMan/templates-user/

3. 

4. 

5. una volta inserito come in foto andate su Docker → Add Container → selezionate "plexcache-d" dai vari template

6. 

7. 

8. 

9. una volta settato tutto fare Apply

STEP 4: WebUI e configurazione delle cartelle

una volta installato aprite la webui e seguite i passaggi guidati iniziali, una volta completati i passaggi iniziali di configurazione, dovrete poi sistemare le cartelle che puntano dalla vostra libreria alla cache quindi:

1. Spostatevi su Settings --> Libraries --> Edit Profile
   

2. sistemate le path con quelle corrispondenti alle vostre librerie e alla vostra cache
   NB: tenete presente che il docker chiama "cache" quello che nel setting avete puntato come cache, quindi se avete m2 o la cartella plex_cacheper il docke è "Cache"

3. sistemato le path fare Save (vanno sistemate una alla volta)

4. fare ora "dry run" per simulare lo spostamento e vedere se tutto ok

5. se non vi ha dato errori fare "RUN"

STEP 5: Schedulazione dei file

1. Spostatevi su Settings --> Schedule --> Simple Interval

2. qui ora dovete fare un calcolo dell'uso che fate di plex per il numero di utenti e nel caso di serie tv quante puntate vedete

3. io ad esempio ho fatto un calcolo di 2 puntate da 1hr al giorno (1 in pausa pranzo e 1 alla sera) ma ho voluto inserire 1 stagione intera (10 puntate di media) con refresh ogni 12hr partendo alle 6 di mattina, così ha tutto il tempo di scansionare la libreria e man mano che vedo le puntate me le risposta nell'array e mi aggiunge le nuove (se ce ne sono) , ho messo 10 puntate perchè anche altri utenti potranno vedere magari più frequente di me altre serie di altre puntate, quindi avranno 1 stagione a disposizione che si aggiornerà sia alle 6 di mattina che alle 18:00

4. una volta che avete settato voi con i vostri calcoli (contate che più sono i file da spostare più ci vuole tempo a scansione) , premete su "Save Schedule" e poi fare "Run"

e così abbiamo configurato tutto!

Spero di esser stato d'aiuto

✨ Pro Tip

Per chi ha fatto l'm2 dedicato: se per qualsiasi motivo non hai la transcodifica sulla ram (vedi la mia guida precedente) crea una cartella Transcoding nell'm2 plex_cache, dopodichè edita il docker di plex e la transcodifica puntala su quella cartella, così avrai 1 m2 totalmente dedicato a Plex senza muovere ulteriori hardware inutilmente

Offre account utente, gruppi e controllo dei permessi adeguati e semplifica la creazione di link di condivisione pubblici senza dover ricorrere a servizi di archiviazione di terze parti. È inoltre possibile estenderla con applicazioni web opzionali che compaiono nell'app switcher e, se in seguito si desidera una collaborazione completa sui documenti, è possibile integrare servizi come Collabora o OnlyOffice.

Su Unraid in particolare, si adatta perfettamente a una configurazione che privilegia le prestazioni: mantiene la configurazione su SSD/cache per garantire la reattività, mentre archivia i file di grandi dimensioni sull'array per garantire la capacità.

Creare cartelle e impostare i permessi (terminale Unraid)

Aprite il terminale di Unraid e digitate un comando per volta:

Creazione cartelle

mkdir -p /mnt/cache/appdata/opencloud/config

mkdir -p /mnt/user/opencloud/data

# Creare la cartella web app per installazione app aggiuntive (per OpenCloud “App Store” downloads che vanno installate a mano)

mkdir -p /mnt/user/opencloud/data/web/assets/apps

# Cambiate i permessi a UID/GID 1000

chown -R 1000:1000 /mnt/cache/appdata/opencloud

chown -R 1000:1000 /mnt/user/opencloud

# Cambiate i permessi della cartella a 751 (solo cartelle)

find /mnt/cache/appdata/opencloud -type d -exec chmod 751 {} \;

find /mnt/user/opencloud -type d -exec chmod 751 {} \;

Installate l app OpenCloud dal CA, va scelta quella di joly0

Nella configurazione dovete cambiare l' OpenCloud URL con il vostro dominio, l'admin password con una password a vostra scelta e aggiungere una nuova variabile
FRONTEND_DISABLE_RADICALE impostandola a true

Create il reverse proxy

A seconda del servizio che usate create la regola di reverse proxy attenzione che il servizio è in https.

Ad esempio con Nginx

Primo login

Username: admin

Password: quella impostata nel docker IDM_ADMIN_PASSWORD

From Admin Settings, you can add users, groups, and manage spaces.

Installazione “App Store” web apps (Draw.io, External Sites, etc.)

OpenCloud’s App Store scarica un zip/archive, ma noi dobbiamo scaricarlo manualmente e metterlo nella cartella che abbiamo creato prima:

/mnt/user/opencloud/data/web/assets/apps

Ora vediamo un esempio per Draw.io

Create una cartella (example: Draw.io)

Esempio di come deve essere (il nome dipende dall app che avete scaricato):

/mnt/user/opencloud/data/web/assets/apps/draw-io/

Mettete il manifesto dell'app (e.g. manifest.json) qua dentr

/mnt/user/opencloud/data/web/assets/apps/draw-io/js/

Mettete i file dell app (e.g. config.js o simiar) dentro la cartella JS

Riavviate OpenCloud e la nuova app sarà presente nell'elenco app.

Perché spostare la transcodifica sulla RAM?

Oltre ai punti già citati, ecco una panoramica completa dei benefici:

I Vantaggi:

• Preservazione dell'Hardware: Riduzione drastica dei cicli di scrittura su SSD (usura del TBW) e HDD.

• Pulizia del Sistema: Nessun residuo di file temporanei; la RAM è volatile, quindi ogni riavvio pulisce tutto automaticamente.

• Performance Pure: La RAM ha latenze infinitamente più basse e larghezze di banda superiori a qualsiasi SSD NVMe, garantendo uno start dei video quasi istantaneo.

• Efficienza Energetica: Meno stress sui dischi meccanici che possono rimanere in spin-down più a lungo.

• Gestione degli Errori: In caso di file sorgente corrotti che bloccano il transcoder, un semplice riavvio del container o del server svuota la cache "incastrata" senza interventi manuali nel file system.

I Contro (Cosa tenere a mente):

• Consumo di Risorse: La RAM dedicata alla transcodifica viene sottratta al sistema. Se hai poca RAM (es. 8GB o meno) e molti utenti simultanei, potresti saturare la memoria causando crash del sistema o del container.

• Limite di Capacità: A differenza di un disco, lo spazio in RAM è limitato. Se provi a transcodificare un file 4K Remux molto pesante verso un dispositivo lento, il buffer in RAM potrebbe riempirsi prima che il file venga consumato, causando interruzioni.

• Volatilità: Se il server si spegne improvvisamente, la sessione di transcodifica corrente è persa (anche se per Plex questo è un problema minore, dato che riprenderà da dove interrotto).

Requisiti Preliminari

Prima di iniziare, assicurati di avere:

1. Una CPU Intel che supporti QuickSync (nel mio caso è un core ultra 7 265k).

2. Il plugin Intel GPU TOP installato da Unraid Community Applications (per caricare i driver correttamente, ma non è necessario, io per dire non l'ho installato).

3. molta ram (nel mio caso ho 64gb ddr5 6400mhz)

Step 1: Configurazione Intel QuickSync (iGPU)

Per far sì che Plex "veda" la tua integrata Intel, dobbiamo mappare il device correttamente.

1. Vai nella tab Docker di Unraid.

2. Clicca sull'icona di Plex e seleziona Edit.

3. Clicca in fondo su "Add another Path, Port, Variable, Label or Device".
   

4. Imposta come segue:
   

   • Config Type: Device

   • Name: Intel GPU

   • Value: /dev/dri

5. Salva e applica.

   Deve venire così:
   

Step 2: Configurazione Transcodifica in RAM

Invece di creare un nuovo path complesso, sfrutteremo la memoria condivisa già esistente in Unraid: /dev/shm.

1. Sempre nell'edit del container Plex, cerca la variabile Transcode Path (o aggiungila come "Path" se non esiste).

2. Imposta l'Host Path a: /dev/shm

3. Imposta il Container Path a: /transcode

4. Salva le modifiche.

Step 3: Impostazioni nel Pannello Plex

1. Apri l'interfaccia Web di Plex.

2. Vai in Impostazioni > Convertitore.

3. Alla voce Cartella temporanea del Convertitore, scrivi (se non c'è già scritto) : /transcode

4. Assicurati che la spunta "Usa l'accelerazione hardware quando disponibile" sia attiva.

il risultato finale dovrebbe essere questo (il nome della vostra iGPU nel mio caso "arrow lake")

Consiglio Extra (se avete fatto anche intel gpu top): Per monitorare che tutto funzioni, apri il terminale di Unraid e digita intel_gpu_top. Se durante una riproduzione vedi la percentuale "Render/3D" o "Video" salire, complimenti: la tua iGPU sta lavorando!

Fate una prova PRIMA SENZA INSTALLARE intel gpu top, vedete il consumo della RAM per vedere se riuscite a supportare la transcodifica con la velocità delle vostre RAM e se vedete l'iGPU se lavora, nel caso funziona ok, altrimenti installate "intel gpu top" e rifate la procedura iGPU

Questa guida è pensata per gli utenti che desiderano ripristinare le funzionalità del plugin NerdTools, un progetto che non è più ufficialmente supportato o implementato nelle versioni di Unraid 7 e successive a causa di divergenze tra gli sviluppatori.

⚠️ DISCLAIMER IMPORTANTE

• Plugin Non Aggiornato: Il progetto "NerdTools" non è più aggiornato attivamente.

• Installazione Manuale: La procedura è manuale ed è consigliata per utenti esperti.

• Notifica di Incompatibilità: Una volta completata l'installazione, riceverai SEMPRE una notifica nell'Action Centre del pannello "APPS" relativa all'incompatibilità del plugin con la versione di Unraid (nonostante i tool inclusi dovrebbero funzionare correttamente).

1️⃣ Installazione del Prerequisito: un-get

Prima di installare NerdTools, è necessario installare un plugin di supporto chiamato un-get.

1. Navigazione Plugin: Nel tuo pannello di controllo di Unraid, vai alla sezione PLUGINS.

2. Installazione: Clicca su Install Plugin.

3. Inserimento URL: Incolla il seguente link nel campo dedicato all'URL remoto:

   https://raw.githubusercontent.com/ich777/un-get/master/un-get.plg
   

4. Conferma: Clicca sul tasto INSTALL.

2️⃣ Installazione del Plugin NerdTools

Ora puoi procedere con l'installazione del plugin principale (segui i riferimenti nell'immagine allegata).

1. Navigazione Plugin: Assicurati di essere nella sezione PLUGINS.

2. Installazione: Clicca su Install Plugin (come indicato dal riferimento '2' nell'immagine).

3. Inserimento URL: Incolla il seguente link del progetto nel campo URL (come indicato dal riferimento '3' nell'immagine):

   https://raw.githubusercontent.com/UnRAIDES/unRAID-NerdTools/main/plugin/NerdTools.plg
   

4. Conferma: Clicca sul tasto INSTALL accanto al campo dell'URL.

Finito! Se i passaggi sono stati seguiti correttamente, NerdTools dovrebbe ora essere installato e funzionante, nonostante la notifica di incompatibilità.

Se hai bisogno di formattare e reinstallare completamente Unraid sulla stessa chiavetta USB su cui era precedentemente installato, puoi farlo facilmente e recuperare la tua chiave di licenza esistente.

🛠 Procedura di Reinstallazione

1. Preparazione e Formattazione:

   • Scarica e installa l'UNRAID USB CREATOR.

   • Utilizza il Creator per formattare la chiavetta USB e installare la versione di Unraid che preferisci (Stabile o Beta).

2. Avvio del Server:

   • Avvia il tuo server utilizzando la chiavetta appena preparata.

   • Assicurati che il server sia connesso ad Internet affinché possa comunicare con il sito di Unraid per il recupero della licenza.

3. Accesso alle Opzioni Chiave:

   • Una volta avviato, il tuo server si presenterà con una schermata iniziale simile a questa (vedi immagine sotto):

     

4. Inizio del Recupero:

   • Seleziona l'opzione Recover Key (Recupera Chiave).

5. Accesso al Sito Web:

   • Selezionando "Recover Key", si aprirà una pagina web nel tuo browser.

   • Esegui il login al sito di Unraid (non sul tuo server, ma sul portale di Unraid).

6. Rilevamento Automatico:

   • Una volta effettuato l'accesso, il sito rileverà automaticamente la tua licenza associata e ti offrirà due opzioni: Auto Install o Manual Install.

Scelta A: Auto Install (Consigliata)

• Auto Install farà tutto automaticamente, installando la licenza sulla tua nuova chiavetta senza ulteriori passaggi.

Scelta B: Manual Install (Se Auto Install Fallisce)

• Se l'installazione automatica dovesse fallire o dare problemi, scegli l'opzione Manual Install.

• Il sito ti fornirà un link o un codice. Dovrai semplicemente incollare questo link (o codice) nel campo Redeem Activation Code presente sulla schermata iniziale del tuo server (come mostrato nell'immagine al punto 3).

Buon divertimento! Il tuo server è ora ripristinato e la licenza è attiva.

Questa guida è pensata per chi vuole riciclare gli HDD precedentemente utilizzati nell'array Unraid e desidera ripartire completamente da zero eseguendo un "reset di fabbrica" della configurazione dei dischi.

⚠️ Attenzione: Questa operazione cancellerà tutte le assegnazioni attuali dei dischi e richiederà una nuova configurazione, potenzialmente portando alla perdita dei dati se non viene eseguita correttamente (anche se i dati fisici sui dischi rimangono fino alla riformattazione).

🛠 Procedura di Reset dell'Array

Segui questi semplici passaggi per resettare la configurazione dei tuoi dischi:

1. Arresto dell'Array:

   • Vai alla schermata principale di Unraid (Main).

   • Fai clic su Stop per arrestare l'array in esecuzione.

2. Accesso agli Strumenti:

   • Nella barra di navigazione superiore, fai clic su Tools (Strumenti).

3. Selezione Nuova Configurazione:

   • Nella pagina degli Strumenti, cerca e seleziona l'opzione New Config (Nuova Configurazione).

4. Conferma e Applicazione:

   • Nella pagina di "New Config", assicurati di aver compreso le implicazioni.

   • Conferma l'operazione (spesso spuntando una casella).

   • Fai clic su Apply (Applica).

✅ Operazione Conclusa

La configurazione dell'array è ora stata resettata. A questo punto, potrai:

• Assegnare i dischi (Parity, Data e Cache) nuovamente come se fossero appena stati installati.

• Formattare i dischi se desideri eliminare i dati precedenti.

Operazione Opzionale: Riassegnazione dei Dischi

Dopo il reset, se vuoi rimettere in funzione i dischi per il nuovo array:

1. Torna alla Schermata Principale (Main):

2. Riassegna i Dischi: Assegna nuovamente i dischi nelle sezioni appropriate:

   • Parity: Seleziona il disco che fungerà da parità.

   • Data Disks: Seleziona tutti i dischi che fungeranno da dischi dati.

   • Cache Disk: (Opzionale) Seleziona il disco da usare come cache.

3. Avvia l'Array:

   • Fai clic su Start per avviare l'array con la nuova configurazione.

4. Formattazione dei Dischi (Obbligatoria per Nuovi Array):

   • Poiché i dischi sono stati appena riassegnati, Unraid ti chiederà di formattarli per unirli al nuovo array.

   • Seleziona la casella di conferma per la formattazione.

   • Fai clic su Format. (consiglio ZFS come tipo di formattazione)

Finito! Il tuo array è resettato, riassegnato e pronto all'uso.

scrissi questa guida tempo fa anche sul gruppo telegram agli albori di Unraid Italia per contribuire alla crescita della community e oggi eccomi qui.

Questa guida è pensata specificamente per gli utenti che utilizzano una chiavetta USB con capacità superiore a 32GB (es. 64GB, 128GB, ecc.) e desiderano avviarla con successo per Unraid (la guida è basata come avvio in modalità Legacy Boot), data anche l'introvabilità o costi irragionevoli di certe chiavette ho pensato possa essere utile per tutti. COMINCIAMO!

🛠 Prerequisiti

• Una chiavetta USB da 128GB (o superiore a 32GB).

• Il programma Unraid.USB.Creator.Win32-2.1 (o versione equivalente).

• Eventualmente, GUIFormat (o programma simile) per la formattazione manuale in FAT32.

• L'archivio ZIP di Unraid (se la formattazione automatica fallisce).

➡️ Procedura Standard

Segui attentamente questi passaggi per creare la tua chiavetta avviabile:

1. Creazione Iniziale: Esegui il programma Unraid.USB.Creator.Win32-2.1 e procedi con l'operazione di WRITE (scrittura) per copiare i file di Unraid sulla chiavetta.

2. Verifica del File System: Una volta che il processo è completato, apri Risorse del computer (o Computer/Questo PC), fai clic con il tasto destro sul drive di Unraid e seleziona Proprietà.

   • Controlla che il file system sia impostato su FAT32.

3. Rendere Avviabile (Make Bootable): SE il drive è in FAT32, entra nella chiavetta USB, individua il file batch MAKE_BOOTABLE.

4. Esecuzione come Amministratore: Fai clic con il tasto destro sul file MAKE_BOOTABLE e seleziona Esegui come amministratore.

5. Completamento del Processo: Si aprirà una finestra del Prompt dei comandi (CMD). Il programma dovrebbe indicare la lettera del drive (es. UNRAID (X:)).

   • Premi INVIO.

   • Attendi finché non compare il messaggio che indica la fine dell'operazione e che ti chiede di premere un tasto per chiudere.

   • Premi nuovamente INVIO per uscire.

6. Finito! La tua chiavetta Unraid è pronta.

⚠️ Gestione degli Errori Comuni

1. Errore Antivirus

Se l'antivirus rileva una minaccia o una manomissione (spesso per il file syslog):

• Azione: Metti il file in eccezione o seleziona Consenti minaccia (o un'opzione simile) nelle impostazioni del tuo antivirus.

• Ripetizione: Ritorna al Punto 3 (Esecuzione del MAKE_BOOTABLE) e ripeti l'operazione.

2. Formattazione non Riuscita in FAT32

Se il programma di creazione USB non ha formattato correttamente la chiavetta in FAT32:

1. Formattazione Manuale: Scarica e utilizza un programma esterno come GUIFormatter per formattare manualmente la chiavetta in FAT32.

2. Preparazione dei File: Scarica l'ultima versione di Unraid dal sito ufficiale in formato .zip ed estrai il contenuto completo dell'archivio direttamente sulla chiavetta USB appena formattata.

3. Ripresa: Ritorna al Punto 3 (Esecuzione del MAKE_BOOTABLE) e continua con la procedura standard.

Nota: Questa procedura è stata testata con successo in modalità Legacy Boot. Se utilizzi UEFI, potresti dover eseguire passaggi aggiuntivi o diversi.

scrivo questa guida per coloro che volessero ricevere le notifiche del proprio server UNRAID direttamente su Telegram.

La procedura è parecchio semplice, ma cercherò lo stesso di coprire tutti i punti anche per chi ha poca dimestichezza.

Passo 1: Creare un bot di Telegram (Opzionale)

Per prima cosa dobbiamo creare un bot, per farlo dobbiamo avviare una chat con https://telegram.me/BotFather e inviare il comando /newbot

Ora rispondiamo alle sue domande nelle quali ci chiederà come vogliamo chiamarlo etc.

Una volta risposto alle sue domande ci verrà fornito un Token che ci servirà su UNRAID per specificare su che bot vogliamo ricevere le notifiche.

Passo 2: Abilitare da UNRAID le notifiche su Telegram

Ora possiamo andare su UNRAID - Settings - Notification Settings

Il bot di telegram è un "Agents" e per poter ricevere le notifiche nella parte in alto dobbiamo mettere le spunte su quelle che vogliamo ricevere

Ora scorriamo tutto al fondo fino alla sezione Telegram e abilitiamolo.
Inseriamo in "Bot access token", se l'abbiamo appena creato è il token che ci ha dato BotFather, se no usiamo quello del bot che preferiamo e clicchiamo su Apply.

Ora torniamo in Telegram nella chat con il nostro Bot:

• Se il bot è nuovo e inviamo sia un /start sia un messaggio random questo servirà ad inizializzare il bot.

• Se il bot viene già usato per altro o comunque non è stato creato apposta per questa funziona dovremmo comunque inviare un /start

Ora torniamo su Unraid e clicchiamo Test

e riceveremo un messaggio dal nostro bot di test

Congratulazioni! ora riceverete le notifiche del vostro UNRAID direttamente su Telegram, potete scegliere quali notifiche volete ricevere e come formattarle.

Happy coding :)

scrivo una guida su come poter avere l'HTTPS per le proprie app ma accessibili solo in locale o con Tailscale senza però l'utilizzo di un dominio.
Se avete un dominio utilizzate la mia altra guida :) Questa quà :)

Passo 1: Spostare l’interfaccia GUI di Unraid su una nuova porta

Prima di andare troppo avanti, dobbiamo liberare le porte 80 e 443 (HTTP e HTTPS) per il nostro reverse proxy.
Per impostazione predefinita, Unraid utilizza queste porte per la GUI al fine di consentire il monitoraggio/configurazione remota.

La maggior parte della documentazione e delle guide presuppone che tu stia esponendo le porte sul tuo router e che il router possa inoltrare il traffico delle porte 80 e 443 a qualunque porta stia usando Nginx Proxy Manager (NPM).
Con questa guida, invece, tutto il traffico http/https bypassa il router e va direttamente sulle porte 80 e 443, quindi dobbiamo modificarne la configurazione e mettere Nginx Proxy Manager al loro posto.

1. Accedi alla GUI di Unraid.

2. Vai su Settings > Management Access.

3. Assicurati che Use SSH sia abilitato e che la porta sia impostata su 22.

   • Questo sarà il nostro accesso di riserva al server nel caso in cui qualcosa vada storto e non sia più possibile accedere alla GUI.

   • Di solito è già attivo di default.

4. Cambia la porta HTTP: da 80 a qualcos’altro, ad esempio 90 o 11080.

   • Scrivi da qualche parte questa modifica! Se dimentichi il numero, non potrai più accedere alla web GUI di Unraid.

   • Assicurati che questa porta non sia in conflitto con quelle utilizzate dai tuoi container Docker.

5. Cambia la porta HTTPS: da 443 a qualcos’altro, ad esempio 453 o 11443.

   • Annota anche questa modifica!

   • Assicurati che non vada in conflitto con quelle utilizzate dai container Docker.

6. Dopo qualche secondo dovresti essere disconnesso dalla GUI di Unraid.

   • Riconnettiti usando la nuova porta digitando:
     X.X.X.X:[Numero Porta]

     • X.X.X.X = l’indirizzo IP del tuo server Unraid

     • [Numero Porta] = il numero di porta che hai assegnato a HTTP nel passo 4.

Congratulazioni! Ora possiamo installare Nginx Proxy Manager per controllare il traffico in arrivo.

Passo 2: Nginx Proxy Manager in funzione

Ora useremo Nginx Proxy Manager (abbreviato in NPM) per gestire tutto il traffico in entrata e instradarlo dove necessario.
Lo utilizziamo per centralizzare l’instradamento del traffico e ottenere i certificati SSL per abilitare l’HTTPS.

1. Nella GUI di Unraid, vai su Apps e cerca Nginx Proxy Manager.

2. Trova quello chiamato "NginxProxyManager" di "Djoss's Repository".

3. Clicca sull’app, quindi su Install.

4. Imposta:

   • HTTP Port: su 80

   • HTTPS Port: su 443

   • Controlla bene che la Web UI Port non vada in conflitto con nessuno dei tuoi altri container Docker.
     Puoi cambiarla se vuoi, ma ricordati il numero per poterci accedere in seguito.

   • Se stai usando reti Docker personalizzate, imposta la variabile Network Type di conseguenza.

5. Clicca su Done e attendi che Docker scarichi tutto e avvii il container.

6. Avvia l’interfaccia web GUI di NPM.

7. Accedi a NPM usando le credenziali di default:

   • Email: admin@example.com

   • Password: changeme

8. Cambia l’email e la password dell’amministratore con qualcosa di nuovo e univoco.

Congratulazioni, Nginx Proxy Manager è ora configurato e in esecuzione sul tuo server Unraid ed è pronto per essere utilizzato.

Passo 3: Installazione di Pi Hole

NOTA: Ho avuto qualche difficoltà nell'installazione di Pi Hole in quanto non è accessibile da Unraid quindi se state eseguendo questi passaggi da un Tunnel di Tailscale non vi funzionerà, non ho trovato ancora una soluzione per questo quindi dovete o essere nella vostra rete locale o dovete installare Tailscale all'interno di PiHole.

Ora useremo Pi Hole per gestire il nostro DNS, questo servirà per far riconoscere a chi usa la nostra rete gli indirizzi locali che creeremo.

1. Nella GUI di Unraid, vai su Apps e cerca Nginx Proxy Manager.

2. Trova quello chiamato "binhex-official-pihole" di "Official Container".

3. Clicca sull’app, quindi su Install.

4. IMPORTANTISSIMO Imposta il Network Type in br0 -> Questo passaggio è fondamentale in quanto Pi Hole deve avere un suo indirizzo IP dedicato sulla tua rete locale

5. In Fixed IP address imposta un indirizzo IP che è libero sulla tua rete locale puoi usare un IP Scanner per controllare quelli liberi

6. Opzionale se usi tailscale:

   • Metti la spunta su "Use tailscale"

   • Imposta un Tailscale Hostname, ad es. pihole

7. Controlla bene che la Web UI Port non vada in conflitto con nessuno dei tuoi altri container Docker.
   Puoi cambiarla se vuoi, ma ricordati il numero per poterci accedere in seguito.

8. Clicca su Done e attendi che Docker scarichi tutto e avvii il container.

9. Opzionale Tailscale:

   • Aprite il log cliccando con il tasto destro sull'iconea di Pi Hole e recuperate il link per fare il login su tailscale con il vostro docker

10. Ora cliccando con il tasto destro sull'iconea di Pi Hole apriamo la Console:

    • Digitiamo pihole setpassword e impostiamo la password che utilizzeremo per accedere alla Web UI

11. Una volta terminato dobbiamo andare sull'indirizzo ip che abbiamo assegnato nel passaggio 5 con la porta del passaggio 7.

12. Accedi a PiHole usando la password che hai creato nel passaggio 10

Congratulazioni, Pi Hole è stato installato correttamente.

Passo 4: Utilizzare Pi Hole come DNS

Questi passaggi saranno indicativi in quanto ogni modem/router ha le sue regole e ogni dispositivo idem.
Quà potete prendere due strade, o assegnare a tutti i dispositivi collegati alla vostra rete Pi Hole come DNS o assegnarlo manualmente solo ad alcuni dispositivi.
Per assegnarlo a tutti i dispositivi:

1. Andate nella pagina di configurazione del vostro modem/router, ad es. 192.168.1.1

2. Ora cercate l'impostazione del Server DHCP è quella sezione dove decidete che indirizzi IP assegnerà il modem ad ogni dispositivo.

3. Quà come Server DNS 1 o Server DNS Preferito dovete mettere l'indirizzo di Pi Hole che avete assegnato al passaggio 5 del passo 3 senza porte, ad es. 192.168.1.200

4. Per rendere effettiva la modifica dovrete probabilmente disconnettere i vostri dispositivi dalla rete e riconnetterli o riavviare il modem/router

Per assegnarlo ai singoli dispositivi:

1. Andate nella pagina di configurazione del vostro dispositivo

2. Nella scheda di rete che state usando cercate le impostazioni del ipv4

3. Quà come Server DNS 1 o Server DNS Preferito dovete mettere l'indirizzo di Pi Hole che avete assegnato al passaggio 5 del passo 3 senza porte, ad es. 192.168.1.200

Per controllare che tutti i passaggi siano andati a buon fine potete tornare nella Web Ui di Pi Hole e in Tools / Network dovreste vedere tutti i dispositivi a cui avete assegnato il DNS

Non andrò nel dettaglio di come impostare Pi Hole in quanto ci sono molte procedure Online che lo spiegano.


Se State usando una VPN:

Se volete usare Pi Hole anche nella vostra VPN dovrete impostare anche in questa Pi Hole come DNS.

Anche quà la procedura cambia da VPN a VPN scriverò quella di Tailscale perchè è quella che uso io.

1. Andate nella admin page di tailscale : https://login.tailscale.com/admin/

2. Ora andate nella tab DNS

3. Nella parte dei Global nameservers cliccate su Add nameserver -> Custom

   • In Nameserver mettete l'indirizzo ip di Pi Hole quello di Tailscale però, ad es. 100.99.99.99

   • Cliccate su Save

4. Ora in Global nameservers vi troverete anche il vostro DNS

5. Potete mettere la spunta su Override DNS Server in modo che quando siete connessi a Tailscale vengano usati questi a prescindere di quelli impostati sul Dispositivo in uso.

6. N.B. Se avete più di un DNS impostato Tailscale sceglierà a sua discrezione quello più veloce quindi può capitare alle volte che il vostro traffico non venga instradato su Pi Hole, ma sugli altri DNS impostati. Per ovviare lasciate solo Pi Hole

7. Andate nella Web Ui di Pi Hole

8. Ora andate in Settings / DNS e in alto a destra cliccate su Basic che diventerà Expert

9. Ora nella parte a sinistra di Interface Settings flaggate Permit all origins

N.B. questa impostazione è PERICOLOSA se Pi Hole ha diretto accesso ad internet, se avete aperto la porta 53. trovate tutte le info al riguardo quà.

Passo 5: Risoluzione con Dominio Personalizzato

Ora per poter usare un dominio personalizzato dobbiamo dire a Pi Hole come risolvere le nostre richieste, in pratica quando cercheremo
https://unraid.local Pi Hole dovrà convertirlo nell'indirizzo IP del nostro Unraid.

Per farlo:

1. Apri la GUI di Pi Hole

2. Vai in Settings -> Local DNS Records

3. Nella parte di Destra List of local DNS records in basso dovrai compilare:

   • Domain = il dominio che hai scelto di usare, ad es. unraid.local

   • Associated IP = l’IP di Unraid, ad es. 192.168.1.100

   • Clicca sul + verde e hai terminato

   • Se vai all'indirizzo che hai scelto, ad es. http://unraid.local ti trovai la pagina di benvenuto di NPM

4. Ora nella parte di sinistra List of local CNAME records dobbiamo definire i reindirizzamenti:

   1. Per farlo dobbiamo compilare:

      • Domain = il sottodominio che hai scelto di usare, ad es. kavita.unraid.local

      • Target Domain = il dominio "madre" a cui punta, nel nostro caso unraid.local

      • Clicca sul + verde e hai terminato

      • Se vai all'indirizzo che hai scelto, ad es. http://kavita.unraid.local ti trovai la pagina di benvenuto di NPM

5. Ripeti il passaggio 4 per ogni servizio che stai ospitando.

Ora possiamo creare i vari reindirizzamenti su NPM per poter accedere alle nostre APP.

1. Apri la GUI di NPM.

2. Vai su Hosts > Proxy Hosts.

3. Clicca su Add Proxy Host (in alto a destra).

4. Compila la finestra di dialogo con queste informazioni:

   • Domain Names = il dominio completo che vuoi assegnare al servizio

     • Premi Tab o Invio dopo aver scritto: se non lo fai, il testo scomparirà e causerà un errore.

   • Scheme = se il servizio accetta traffico http o https sulla porta indicata

   • Forward Hostname/IP = l’IP Tailscale del servizio (di solito il tuo server Unraid)

   • Forward Port = la porta su cui gira il servizio

     • La trovi nei container Docker della GUI di Unraid

   • Cache Assets = scegli se vuoi che NPM faccia caching degli asset del servizio

   • Block Common Exploits = attivo (a volte può dare problemi, ma di default conviene tenerlo attivo)

   • Websockets Support = attivalo se il servizio richiede websocket

   • Access List = Publicly Accessible

5. Testa il dominio personalizzato digitandolo nel browser: dovresti essere indirizzato al tuo servizio.

6. Ripeti i passaggi 3–4 per ogni servizio che stai ospitando.

Passo 5: SSL e HTTPS

Non avendo un Dominio non possiamo usare Let's Encrypt o simili per ottenere un certificato, ma dovremmo per forza usare un certificato
Self-Signed, questo triggererà un warning quando andremo sul nostro sito web, ma la connessione sarà comunque protetta HTTPS.

Per farlo potete usare qualsiasi strumento che preferiate io per comodità uso openssl e creo un certificato wildcars così da farne uno solo e non doverlo mai più toccare.

Il comando che uso è
openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 3650 -subj "/C=IT/ST=Some-State/L=City/O=MyCompany/OU=MyDept/CN=*.unraid.local/emailAddress=Random-Email" -addext "subjectAltName=DNS:*.unraid.local,DNS:unraid.local"

I parametri da cambiare sono:

"/C=IT/ST=Some-State/L=City/O=MyCompany/OU=MyDept/CN=*.unraid.local/emailAddress=Random-Email"

• C = Stato in cui vi trovate, 2 lettere as es. IT.

• ST = Stato/Provincia in cui vi trovate, ad es. Lombardia

• L = Città in cui vi trovate, ad es. Milano

• O = Organizzazione, questo da compilare se è un certificato aziendale se no lasciatelo generico

• OU = Dipartimento, questo da compilare se è un certificato aziendale se no lasciatelo generico

• CN = Nome principale del dominio, ad es. *.unraid.local

• emailAddress = Indirizzo mail del certificato, ad es. pippo@pluto.com

Dovete poi sistemare anche
"subjectAltName=DNS:*.unraid.local,DNS:unraid.local"

Questo significa che il certificato sarà valido per:

• unraid.local

• qualsiasi sottodominio di unraid.local (grazie a *)

Questo genera un certificato *.unraid.local che sarà valido per qualsiasi sottodominio, potete ovviamente cambiarlo a vostro piacimento.
Una volta ottenuti i certificati dobbiamo caricarli su NPM

Procedura in NPM:

1. Apri NPM e vai su SSL Certificates.

2. Clicca su Add SSL Certificate e poi su Custom.

3. Inserisci le informazioni nei campi:

   • Name = Un nome che ti ricordi che certificato è in quanto dopo non potremmo più vederlo

     • Esempio: *.unraid.local

   • Certificate Key = il key.pem che abbiamo ottenuto/generato

   • Certificate = il cert.pem che abbiamo ottenuto/generato

   • Intermediate Certificate = il certificato intermedio nel caso l'avessimo se no lasciare vuoto.

4. Clicca su Save.

5. Attendi che il sistema processi la richiesta.

   • Può richiedere qualche minuto, abbi pazienza.

6. Il tuo certificato dovrebbe ora comparire nell’elenco.

7. Vai su Hosts > Proxy Hosts.

8. Seleziona il dominio associato e clicca sul menu a tre puntini, poi su Edit.

9. Clicca su SSL in alto nella finestra di dialogo.

10. Seleziona il certificato SSL creato per quel dominio dal menu a tendina.

11. Ripeti i passaggi 1–11 per ogni sottodominio che stai usando, se hai utilizzato una wildcard assegna a tutti lo stesso certificato.

A questo punto, i tuoi servizi sono protetti da SSL e raggiungibili tramite HTTPS, una volta confermato la prima volta che il certificato Self-Signed è sicuro non ci uscirà più il warning :)

scrivo questa guida per chi ha fatto l'aggiornamento dal UNRAID 6 a 7 e ha perso le funzionalità legate a Nerdtools.

Queste non funzionano più in quanto openssl non è più presente di default sul nostro sistema, ma dovremmo andarlo ad installare noi a mano.

Essendo un pacchetto che viene aggiornato spesso io userò la versione presente al momento, ma voi dovrete usare quello che troverete quando seguirete questa guida.

Passo 1: Recuperare lo slackware di openssl

Andate su https://slackware.uk/slackware/slackware64/patches/packages/ e cercate openssl quello che interessa a noi termina con .txz e al momento in cui scrivo si chiama
openssl-1.1.1zb_p2-x86_64-1_slack15.0.txz

Ora copiatevi il nome di questo pacchetto da qualche parte.

Passo 2: Scaricare OpenSSL su UNRAID

Aprite il terminale di UNRAID e muovetevi in /boot/extra con il comando cd /boot/extra

Quà ora scaricate il pacchetto di cui ci siamo salvati il nome prima digitando il comando
wget --no-check-certificate https://slackware.uk/slackware/slackware64/patches/packages/NOME_DEL_PACCHETTO_OPENSSL

Nel mio caso sarà

wget --no-check-certificate https://slackware.uk/slackware/slackware64/patches/packages/openssl-1.1.1zb_p2-x86_64-1_slack15.0.txz

Passo 3: Installare OpenSSL su UNRAID

Una volta finito il download non dobbiamo fare altro che installarlo e possiamo farlo usando il comando:
installpkg NOME_DEL_PACCHETTO_OPENSSL

Nel mio caso sarà:

installpkg openssl-1.1.1zb_p2-x86_64-1_slack15.0.txz

Una volta terminata l'installazione tutti i pacchetti di Nerdtools torneranno a funzionare :)

N.B. La procedura di installazione va rieseguita ogni volta che riavviate UNRAID, potete creavi uno User Script in modo che venga rieseguita in automatico

faccio questa mini guida per chi stesse cercando di impostare il tema scuro.

Per farlo basta andare in Settings -> Display Settings

e giocare con le impostrazioni del Dynamix color Theme, per avere anche la barra in alto nera dovete cambiare i parametri Header custom text color e Header custom background color.

Impostandoli rispettivamente a ffffff e 333333 avrete anche la barra in alto Dark/Scura

scrivo una guida su come poter avere l'HTTPS per le proprie app ma accessibili solo in locale o con Tailscale.

Se non avete un dominio utilizzate la mia altra guida :) Questa quà :)

Passo 1: Spostare l’interfaccia GUI di Unraid su una nuova porta

Prima di andare troppo avanti, dobbiamo liberare le porte 80 e 443 (HTTP e HTTPS) per il nostro reverse proxy.
Per impostazione predefinita, Unraid utilizza queste porte per la GUI al fine di consentire il monitoraggio/configurazione remota.

La maggior parte della documentazione e delle guide presuppone che tu stia esponendo le porte sul tuo router e che il router possa inoltrare il traffico delle porte 80 e 443 a qualunque porta stia usando Nginx Proxy Manager (NPM).
Con questa guida, invece, tutto il traffico http/https bypassa il router e va direttamente sulle porte 80 e 443, quindi dobbiamo modificarne la configurazione e mettere Nginx Proxy Manager al loro posto.

1. Accedi alla GUI di Unraid.

2. Vai su Settings > Management Access.

3. Assicurati che Use SSH sia abilitato e che la porta sia impostata su 22.

   • Questo sarà il nostro accesso di riserva al server nel caso in cui qualcosa vada storto e non sia più possibile accedere alla GUI.

   • Di solito è già attivo di default.

4. Cambia la porta HTTP: da 80 a qualcos’altro, ad esempio 90 o 11080.

   • Scrivi da qualche parte questa modifica! Se dimentichi il numero, non potrai più accedere alla web GUI di Unraid.

   • Assicurati che questa porta non sia in conflitto con quelle utilizzate dai tuoi container Docker.

5. Cambia la porta HTTPS: da 443 a qualcos’altro, ad esempio 453 o 11443.

   • Annota anche questa modifica!

   • Assicurati che non vada in conflitto con quelle utilizzate dai container Docker.

6. Dopo qualche secondo dovresti essere disconnesso dalla GUI di Unraid.

   • Riconnettiti usando la nuova porta digitando:
     X.X.X.X:[Numero Porta]

     • X.X.X.X = l’indirizzo IP del tuo server Unraid

     • [Numero Porta] = il numero di porta che hai assegnato a HTTP nel passo 4.

Congratulazioni! Ora possiamo installare Nginx Proxy Manager per controllare il traffico in arrivo.

Passo 2: Nginx Proxy Manager in funzione

Ora useremo Nginx Proxy Manager (abbreviato in NPM) per gestire tutto il traffico in entrata e instradarlo dove necessario.
Lo utilizziamo per centralizzare l’instradamento del traffico e ottenere i certificati SSL per abilitare l’HTTPS.

1. Nella GUI di Unraid, vai su Apps e cerca Nginx Proxy Manager.

2. Trova quello chiamato "NginxProxyManager" di "Djoss's Repository".

3. Clicca sull’app, quindi su Install.

4. Imposta:

   • HTTP Port: su 80

   • HTTPS Port: su 443

   • Controlla bene che la Web UI Port non vada in conflitto con nessuno dei tuoi altri container Docker.
     Puoi cambiarla se vuoi, ma ricordati il numero per poterci accedere in seguito.

   • Se stai usando reti Docker personalizzate, imposta la variabile Network Type di conseguenza.

5. Clicca su Done e attendi che Docker scarichi tutto e avvii il container.

6. Avvia l’interfaccia web GUI di NPM.

7. Accedi a NPM usando le credenziali di default:

   • Email: admin@example.com

   • Password: changeme

8. Cambia l’email e la password dell’amministratore con qualcosa di nuovo e univoco.

Congratulazioni, Nginx Proxy Manager è ora configurato e in esecuzione sul tuo server Unraid ed è pronto per essere utilizzato.

Passo 3: Risoluzione con Dominio Personalizzato

NOTA: Questi passaggi sono volutamente generici, perché ogni provider DNS è diverso. Dovrai adattarli al tuo caso. In linea generale, si tratta di aggiungere un record A al tuo dominio e puntarlo all’indirizzo IP Tailscale del tuo server Unraid.

1. Accedi al tuo provider DNS.

   • Di solito è lo stesso servizio da cui hai acquistato il dominio (GoDaddy, NameCheap, Google Domains, ecc.).

2. Vai alla pagina che ti permette di modificare i record del dominio che vuoi usare.

3. Crea un nuovo record A:

   • Hostname = @

   • IP Address = l’indirizzo IPv4 Tailscale del server Unraid

4. Attendi la propagazione del record DNS agli altri server.

   • Può richiedere fino a 48 ore.

   • Nella mia esperienza i cambiamenti avvengono abbastanza velocemente (~5 minuti).

5. Testa l’instradamento digitando il tuo dominio (es. example.com) su un dispositivo connesso alla tua rete interna.

   • Dovresti vedere la pagina iniziale di NPM.

   • Se ti disconnetti e ricarichi la pagina, la pagina di NPM non dovrebbe più caricarsi.

6. Per ogni servizio che vuoi ospitare, crea un nuovo record CNAME:

   • Hostname = il nome che vuoi dare al servizio

     • Esempio: nextcloud.example.com

   • Value = il tuo dominio (es. example.com)

7. Attendi la propagazione dei cambiamenti DNS (vedi nota al passo 5).

8. Apri la GUI di NPM.

9. Vai su Hosts > Proxy Hosts.

10. Clicca su Add Proxy Host (in alto a destra).

11. Compila la finestra di dialogo con queste informazioni:

    • Domain Names = il dominio completo che vuoi assegnare al servizio

      • Premi Tab o Invio dopo aver scritto: se non lo fai, il testo scomparirà e causerà un errore.

    • Scheme = se il servizio accetta traffico http o https sulla porta indicata

    • Forward Hostname/IP = l’IP Tailscale del servizio (di solito il tuo server Unraid)

    • Forward Port = la porta su cui gira il servizio

      • La trovi nei container Docker della GUI di Unraid

    • Cache Assets = scegli se vuoi che NPM faccia caching degli asset del servizio

    • Block Common Exploits = attivo (a volte può dare problemi, ma di default conviene tenerlo attivo)

    • Websockets Support = attivalo se il servizio richiede websocket

    • Access List = Publicly Accessible

12. Testa il dominio personalizzato digitandolo nel browser: dovresti essere indirizzato al tuo servizio.

13. Ripeti i passaggi 6–13 per ogni servizio che stai ospitando.

Congratulazioni, ora i tuoi servizi sono accessibili tramite domini personalizzati all’interno della tua rete Tailscale.

Passo 4: SSL e HTTPS

Il metodo standard per configurare i certificati SSL di Let’s Encrypt prevede che il server remoto validi la tua proprietà del dominio cercando un file ospitato sul tuo server. Ovviamente questo non funziona quanto il reindirizzamento del dominio punta ad un ip locale.
Invece, useremo una sfida DNS (DNS challenge) per autenticare la proprietà del dominio.

• In pratica, invece di caricare un file sul server, aggiungeremo un record DNS contenente una stringa di testo fornita da Let’s Encrypt.

• Poiché quella stringa non era presente prima e lo è dopo la richiesta, Let’s Encrypt deduce che siamo noi ad averla aggiunta e quindi proprietari del dominio.

Procedura in NPM:

1. Apri NPM e vai su SSL Certificates.

2. Clicca su Add SSL Certificate e poi su Let's Encrypt..

3. Inserisci le informazioni nei campi:

   • Domain Names = il dominio completo, con eventuali sottodomini

     • Esempio: cloud.example.com

   • Email Address for Let’s Encrypt = un indirizzo email reale che Let’s Encrypt possa contattare

     • Ti avviseranno via mail in caso di problemi, quindi deve essere monitorato.

   • Use a DNS Challenge = attiva

   • DNS Provider = il tuo provider DNS

   • Credentials File Content = simile a quando modifichi record DNS o apri porte sul router: ci sono molte variabili. Consulta la documentazione del tuo provider DNS e il testo mostrato nella finestra.

   • Propagation Seconds = puoi lasciare vuoto

4. Accetta i Termini e Condizioni di Let’s Encrypt.

5. Clicca su Save.

6. Attendi che il sistema processi la richiesta.

   • Può richiedere qualche minuto, abbi pazienza.

7. Il tuo certificato dovrebbe ora comparire nell’elenco.

8. Vai su Hosts > Proxy Hosts.

9. Seleziona il dominio associato e clicca sul menu a tre puntini, poi su Edit.

10. Clicca su SSL in alto nella finestra di dialogo.

11. Seleziona il certificato SSL creato per quel dominio dal menu a tendina.

12. Ripeti i passaggi 1–11 per ogni sottodominio che stai usando.

A questo punto, i tuoi servizi sono protetti da SSL e raggiungibili tramite HTTPS.