Guida Introduttiva: Self-Hosted

Questa guida ti accompagnerà nell’installazione e configurazione della versione auto-ospitata (self-hosted) di SagraFacile.

Panoramica

La versione self-hosted di SagraFacile è progettata per essere eseguita sulla tua infrastruttura locale utilizzando Docker. Questo ti dà il pieno controllo sui tuoi dati e garantisce che il sistema funzioni anche senza una connessione internet costante durante l’evento.

Prerequisiti

Prima di iniziare, assicurati di avere installato i seguenti software:

Docker e Docker Compose: Necessari per eseguire l’applicazione. Se non li hai, segui le guide ufficiali:
- Installa Docker Desktop (per Windows e macOS)
- Installa Docker Engine (per Linux)
Un editor di testo: Qualsiasi editor come VS Code, Sublime Text o Blocco Note andrà bene per modificare i file di configurazione.
Un dominio e accesso a Cloudflare: Necessario per la gestione automatica dei certificati SSL/TLS.

Configurazione della Rete (Importante!)

Una corretta configurazione della rete è essenziale per il funzionamento di SagraFacile.

IP Statico per il Server: Assegna un indirizzo IP locale statico al computer che ospiterà SagraFacile (es. 192.168.1.10).
Dominio su Cloudflare: Il tuo dominio deve essere gestito tramite Cloudflare. Crea un record DNS di tipo A che punti all’indirizzo IP pubblico della tua rete. Questo è necessario per la validazione del certificato SSL, anche se l’accesso avverrà solo localmente.
DNS Locale (Fondamentale): Configura il tuo router per risolvere il tuo dominio (es. pos.sagrafacile.it) all’indirizzo IP locale del server. Questa funzione è spesso chiamata “Local DNS”, “DNSMasq” o “Static Hostname”. Questo passaggio garantisce che i dispositivi nella tua rete locale si connettano direttamente al server locale.

Per una guida dettagliata, consulta il documento sull’architettura di rete.

Installazione

Scarica SagraFacile:
- Scarica l’ultima versione del pacchetto SagraFacile-vX.Y.Z-dist.zip dalla pagina delle Releases su GitHub .
- Estrai il file ZIP in una cartella sul tuo computer.
Crea un API Token su Cloudflare:
- Vai su Cloudflare: “My Profile” > “API Tokens” > “Create Token”.
- Usa il template “Edit zone DNS”.
- Permessi: Zone:DNS:Edit.
- Risorse: Seleziona il tuo dominio specifico.
- Copia il token generato. Ti servirà durante la configurazione.
Esegui lo Script di Configurazione Interattivo:
- Apri un terminale nella cartella di SagraFacile.
- Su macOS/Linux: Esegui chmod +x *.sh e poi ./start.sh.
- Su Windows: Esegui start.bat.
- Lo script ti guiderà nella configurazione, chiedendoti:
  - Il tuo nome di dominio completo (es. pos.sagrafacile.it).
  - Il tuo API Token di Cloudflare.
  - Le credenziali per il database.
  - Una chiave segreta per JWT (può essere generata automaticamente).
  - Se desideri caricare dati demo o creare una nuova organizzazione.
Lo script salverà la configurazione e avvierà tutti i servizi tramite docker-compose.

Accesso a SagraFacile

Una volta che i servizi sono attivi e il certificato SSL è stato ottenuto, apri un browser da qualsiasi dispositivo connesso alla tua rete locale e naviga a https://tuo.dominio.com.

Dovresti vedere la pagina di login di SagraFacile. Grazie al certificato Let’s Encrypt, la connessione sarà sicura e non richiederà installazioni di certificati sui dispositivi client.