Installazione di YunoHost

Selezionate l'hardware sul quale vuoi installare YunoHost:

Pre-requisiti

  • Un Raspberry Pi 3, 4 o 5
  • Una fonte di alimentazione (che può essere un alimentatore o un semplice cavo MicroUSB) adatto alla scheda
  • Una scheda microSD: almeno di 16 GB, di classe "A1" raccomandata (come questa SanDisk A1 card);
  • Un ISP ragionevole, preferibilmente con una banda in uscita buona senza limiti
  • Un cavo ethernet (RJ-45) per collegare il vostro server al router.
  • Un computer per leggere questa guida, copiare l'immagine e accedere al vostro server.
  • Scaricate l'immagine YunoHost

    Se volete controllare la validità delle nostre immagini firmate potete scaricare la nostra chiave pubblica.

    card microSD con l'adattatore Flashate l'immagine YunoHost

    L'immagine YunoHost che avete appena scaricato la potete flashare su una scheda microSD

    Scaricate Etcher per il vostro sistema operativo e installatelo.

    Inserite la scheda SD, selezionate la vostra immagine e cliccate su "Flash!"

    Etcher

    Accendete la scheda

    • Inserite il cavo ethernet (un capo al vostro router principale e l'altro capo alla scheda).
    • Inserite la schedina SD nella scheda
    • (Opzionale) Potete connettere tastiera e schermo direttamente alla scheda se volete controllare il processo di boot oppure se preferite "vedere quel che accade" o se volete un accesso diretto alla scheda stessa.
    • Avviate la scheda
    • Attendete un paio di minuti mentre la scheda di autoconfigura durante il primo avvio
    • Assicuratevi che il vostro computer (desktop/portatile) sia connesso alla stessa rete locale (ad esempio al router internet) del server.

    Proseguite con la configurazione iniziale

    Se state recuperando un server da un backup YunoHost non dovete seguire questo passaggio e invece recuperare un backup invece del passo del postinstall.

    In an internet browser, type https://yunohost.local (or yunohost-2.local, and so on if multiple YunoHost servers are on your network).

    Se non dovesse funzionare potete cercare il vostro indirizzo IP locale del vostro server. L'indirizzo normalmente è del tipo 192.168.x.y e quindi dovrete scrivere https://192.168.x.y nella barra degli indirizzi del vostro browser.

    Al momento della prima visita molto probabilmente troverete un allarme di sicurezza relativo al certificato usato dal server. Per adesso il vostro server sta usando un certificato auto-firmato. Potrete installare successivamente un certificato automaticamente riconosciuto dai browser web come descritto nella documentazione sul certificato. Per adesso potete aggiungere un'eccezione di sicurezza per accettare il certificato corrente. (Però, PER FAVORE, non prendete l'abitudine di accettare ciecamente questo tipo di allarme di sicurezza!)

    Dovreste arrivare su questa pagina :

    Pagina della configurazione iniziale

    Anteprima della pagina Web della configurazione iniziale

    Dominio principale

    Questo sarà il dominio usato dagli utenti del server per accedere al portale di autenticazione. Potrete aggiungere poi altri domini e scegliere quale è il principale se necessario.

    • Se siete alle prime esperienze del self-hosting e non avete già un nome a dominio noi raccomandiamo l'uso di .nohost.me / .noho.st / .ynh.fr (come ad esempio homersimpson.nohost.me). Ammesso che non sia stato già assegnato, il dominio verrà configurato automaticamente e non dovrete compiere nessun altro passo di configurazione. Considerate che di contro non avrete il pieno controllo sulla configurazione del DNS.

    • Se avete già un nome a dominio lo potete usare probabilmente qui. Dovrete poi configurare i record DNS come spiegato qui.

    Sì, è necessario configurare un nome a dominio. Se non avete un nome a dominio e non volete neanche un dominio .nohost.me / .noho.st / .ynh.fr potete configurare un dominio fasullo come ad esempio yolo.test e modificare il vostro file locale /etc/hosts di modo chequesto dominio fasullo punti all'IP appropriato come spiegato qui.

    Primo utente

    Il primo utente viene creato a questo passo. Dovreste scegliere un nome utente e una password ragionevolmente complessa. (Non ci stancheremo mai di raccomandare che la password deve essere robusta!). Questo utente verrà aggiunto al gruppo Admins e quindi potrà accedere al portale utente, alla pagina web di amministrazione e connettersi via SSH o SFTP. Gli utenti del gruppo Admins riceveranno inoltre le email inviate a root@yourdomain.tld e admin@yourdomain.tld: questi messaggi potrebbero essere usate per mandare informazioni tecniche o allarmi. È possibile aggiungere successivamente ulteriori utenti che possono essere aggiunti al gruppo Admins.

    Questo utente rimpiazza il precedente utente admin al quale potrebbero far riferimento alcune vecchie pagina della documentazione. Nel caso è sufficiente sostituire admin con il vostro nome utente.

    Avviate la diagnosi iniziale

    Una volta che il passo del postinstall è concluso dovreste essere in grado di fare login alla pagina web di amministrazione usando le credenziali del primo utente che avete appena creato.

    Il sistema di diagnosi è pensato per offrire un modo semplice per verificare che tutti gli aspetti critici del vostro server sono correttamente impostati - e guidarvi nel risolvere in problemi. Il sistema di diagnosi si avvierà due volte al giorni e invierà un allarme se verranno individuati dei problemi.

    N.B.: non scappate! La prima volta che avvierete il sistema di diagnosi vedrete quasi sicuramente molti allarmi gialli e rossi perché normalmente dovete configurare i record DNS (a meno che non usiate dei domini .nohost.me/noho.st/ynh.fr), aggiungere un file di swap se non avete sufficiente ram e/o configurare il port forwarding.

    Se un allarme non è per voi preoccupante (perché per esempio non intendete usare un particolare feature) è assolutamente corretto marcare il problema come ignora nella pagina di amministrazione web > Diagnosi cliccando sul bottone ignora del problema in questione.

    Per avviare una diagnosi collegatevi alla pagina web di amministrazione nella sezione Diagnosi. Cliccate su Avvia diagnosi iniziale e dovreste ottenre una schermata simile a questa:

    Anteprima di una pagina diagnostica

    Ottenere un certificato Let's Encrypt

    Una volta configurati i record DNS ed eventualmente il port forwarding dovreste essere in grado di installare un certificato Let's Encrypt. In questo modo dovrebbero scomparire gli allarmi di sicurezza visti sopra per i nuovi visitatori.

    Per maggiori informazioni o per conoscere meglio i certificati SSL/TLS vedi questa pagina.

    Andate su Domini > cliccate sul vostro dominio > Certificate

    Anteprima di una pagina diagnostica

    Congratulazioni

    Adesso avete un server ben configurato. Se siete alle prime esperienze di YunoHost è consigliabile guardare il tour guidato. Dovreste essere in grado di installare le vostre applicazioni preferite. Non dimenticate di programmare i backup!

    Hai trovato degli errori? Pensi di poter migliorare questa documentazione? Simply click the Edit link at the top of the page, and then the icon on Github to suggest changes.