🌋 Guida di Avvio Rapido

Questa guida ti mostrerà come avviare un'istanza locale del sistema di monitoraggio ETNA. Segui questi passaggi per configurare il tuo ambiente e lanciare i servizi.

1. Prerequisiti

Prima di iniziare, assicurati di avere a disposizione tutto il necessario.

🖥️

Host con Docker

Un server o un computer con Docker e Docker Compose installati e funzionanti.

🌐

Dominio Pubblico

Un nome di dominio (es. etna.esempio.com) che punta all'indirizzo IP pubblico del tuo host.

🤖

Credenziali Telegram

Un token per il bot, l'ID della chat di destinazione e il tuo username per i comandi autorizzati.

📂

Codice Sorgente

Il repository del progetto clonato sul tuo host.

2. Configurazione e Avvio

Clona il Repository

Ottieni il codice sorgente dal repository ufficiale e naviga nella directory del progetto.

git clone https://github.com/gnovelli/etna.git
cd etna

Crea il file di configurazione `.env`

Crea un file chiamato .env nella root del progetto e inserisci le tue credenziali e il tuo dominio. Puoi usare env.example come modello se presente.

# Credenziali del tuo Bot Telegram
TELEGRAM_BOT_TOKEN=IL_TUO_TOKEN_SEGRETO
TELEGRAM_CHAT_ID=L_ID_DELLA_TUA_CHAT
TELEGRAM_ALLOWED_USERNAME=IL_TUO_USERNAME_TELEGRAM

# Dominio del tuo host
ETNA_HOST=etna.tuodominio.com

# Impostazioni di default per il modello AI (puoi lasciarle così)
OLLAMA_MODEL=qwen3:1.7b
OLLAMA_URL=http://ollama:11434

Ottieni il Certificato SSL (Solo la prima volta)

Per abilitare l'HTTPS, esegui questi comandi per ottenere un certificato da Let's Encrypt. Sostituisci tua@email.com con il tuo indirizzo email.

# Avvia il container per la validazione HTTP
docker-compose up -d nginx-challenge

# Esegui Certbot per ottenere il certificato
docker-compose run --rm certbot certonly --webroot -w /var/www/certbot -d ${ETNA_HOST} --email tua@email.com --agree-tos --non-interactive

# Ferma il container di validazione
docker-compose stop nginx-challenge

Avvia tutti i Servizi Principali

Questo comando avvierà il servizio etna-service, il proxy nginx per il traffico HTTPS e il container certbot per il rinnovo automatico dei certificati.

docker-compose up -d nginx certbot etna-service

🎉 Fatto!

Il tuo sistema di monitoraggio è ora attivo. Lo scheduler eseguirà le analisi secondo la pianificazione e potrai interagire con il bot tramite i comandi /report, /status, /polar e /menu.