Questo post è un bigino operativo per la creazione di una nuova applicazione su YunoHost, partendo dalla configurazione DNS fino all’installazione dell’app.

Dominio principale: alanleoni.ch
Registrar/DNS: Infomaniak
Server: YunoHost

Panoramica dei passi

  1. Configurare DNS (record A e AAAA) su Infomaniak
  2. Creare il sottodominio su YunoHost
  3. Installare il certificato HTTPS (Let’s Encrypt)
  4. Installare l’app

Configurazione DNS su Infomaniak

Creare i record DNS per il sottodominio (es. app.alanleoni.ch).

Record IPv4 (A)

  • Tipo: A
  • Nome: app
  • Valore: IPV4_DEL_SERVER

Record IPv6 (AAAA)

  • Tipo: AAAA
  • Nome: app
  • Valore: IPV6_DEL_SERVER

Verifica dal server:

dig app.alanleoni.ch A
dig app.alanleoni.ch AAAA

Creazione del dominio (sottodominio) su YunoHost

Aggiungere il sottodominio a YunoHost:

sudo yunohost domain add app.alanleoni.ch

Verifica che il dominio sia presente:

sudo yunohost domain list

Installazione certificato Let’s Encrypt

Una volta che il DNS risponde correttamente, installare il certificato HTTPS:

sudo yunohost domain cert install app.alanleoni.ch

Verifica stato certificati:

sudo yunohost domain cert status

Se fallisce:

  • controllare DNS
  • controllare porte 80/443 aperte
  • controllare eventuale proxy/firewall

Installazione dell’app

Elenco app disponibili

sudo yunohost app list

Installazione app

sudo yunohost app install nome_app

Durante l’installazione:

  • scegliere app.alanleoni.ch come dominio
  • scegliere il path (/ se uso il sottodominio solo per quell’app )
  • configurare utenti (se richiesto dall’app)

Verifica finale

  • Aprire nel browser:
    https://app.alanleoni.ch
  • Controllare:
    • HTTPS valido
    • accesso all’app
    • log di YunoHost in caso di problemi

Log utili:

sudo yunohost log list
sudo yunohost log show ID_LOG

Comandi utili di debug

DNS:

dig app.alanleoni.ch

Certificati:

sudo yunohost domain cert status
sudo yunohost domain cert renew --force

App:

sudo yunohost app info nome_app
sudo yunohost app remove nome_app

Note

  • Creare sempre prima il DNS, poi il dominio su YunoHost
  • HTTPS va installato prima dell’app