Per chi gestisce un'infrastruttura IT, un blog aziendale o una serie di servizi di rete, la disponibilità online (uptime) è tutto. Scoprire che il proprio sito web o un server aziendale è offline dai clienti o, peggio, dopo ore di inattività, rappresenta un danno d'immagine ed economico notevole.
Se cerchi un'alternativa open source, autonoma e graficamente impeccabile a servizi commerciali come StatusCake o UptimeRobot, la risposta è Uptime Kuma. In questa guida vedremo cos'è questo straordinario strumento di monitoraggio self-hosted e come installarlo su Ubuntu 24.04 LTS usando Docker Compose.
Cos'è Uptime Kuma?
Uptime Kuma è uno strumento di monitoraggio delle prestazioni e dello stato della rete self-hosted. Offre un'interfaccia web moderna, reattiva (ispirata alle migliori dashboard commerciali) e incredibilmente facile da usare, senza limitazioni sul numero di monitor o di notifiche.
Le Funzionalità Principali:
- Monitoraggio Multi-Protocollo: Controlla lo stato di host tramite HTTP(S), Ping, TCP Port, record DNS, container Docker, Steam Game Server e molto altro.
- Sistemi di Notifica Integrati: Supporta oltre 90 servizi di notifica per avvisarti istantaneamente in caso di downtime (tra cui Telegram, Discord, WhatsApp, Signal, Email SMTP, Microsoft Teams e Webhook personalizzati).
- Pagine di Stato Pubbliche: Permette di creare pagine di stato eleganti e personalizzabili da mostrare ai propri clienti per comunicare la trasparenza dei servizi.
- Supporto Proxy e Multi-Lingua: Tradotto nativamente in italiano e predisposto per lavorare dietro Reverse Proxy con certificati SSL.
Guida Pratica all'Installazione con Docker Compose
L'installazione tramite Docker garantisce un ambiente isolato e un consumo di risorse estremamente ridotto (poche decine di megabyte di RAM).
1. Preparazione della cartella di progetto
Accedi al tuo server Ubuntu tramite SSH e prepara la directory dedicata:
bash
sudo mkdir -p /opt/uptime-kuma sudo chown -R $USER:$USER /opt/uptime-kuma cd /opt/uptime-kuma
Usa il codice con cautela.
2. Creazione del file docker-compose.yml
Crea il file di configurazione con Nano:
bash
nano docker-compose.yml
Usa il codice con cautela.
Incolla la seguente configurazione ufficiale e ottimizzata:
yaml
version: "3.8" services: uptime-kuma: image: louislam/uptime-kuma:1 container_name: uptime-kuma restart: unless-stopped ports: - "3001:3001" volumes: - ./data:/app/data # Opzionale: permette ad Uptime Kuma di monitorare lo stato degli altri container Docker locali - /var/run/docker.sock:/var/run/docker.sock
Usa il codice con cautela.
Salva ed esci (Ctrl+O, Invio, Ctrl+X).
3. Avvio del servizio
Avvia il container in background:
bash
docker compose up -d
Usa il codice con cautela.
Al termine del processo, la dashboard sarà accessibile tramite browser all'indirizzo http://IP-DEL-TUO-SERVER:3001. Al primo accesso ti verrà chiesto di impostare la lingua dell'interfaccia (italiano disponibile) e di creare l'account amministratore principale.
Configurazione di un Monitor e delle Notifiche su Telegram
Configurare il primo monitoraggio richiede meno di un minuto. Nella dashboard principale, clicca su "Aggiungi Nuovo Monitor":
- Tipo di monitor: Scegli HTTP(s) per un sito web o Ping per un server locale.
- Nome Amichevole: Es. "Sito Web Aziendale".
- URL / Host: Inserisci l'indirizzo da controllare (es. https://digitaleutile.it).
- Intervallo di controllo: Imposta ogni quanti secondi effettuare il test (60 secondi è il valore standard ottimale).
Impostare le Notifiche di Emergenza
Per ricevere un avviso immediato sullo smartphone quando un servizio va offline, clicca su "Imposta Notifiche":
- Scegli Telegram come tipo di notifica.
- Inserisci il Bot Token (ottenibile gratuitamente tramite BotFather su Telegram) e il tuo Chat ID.
- Clicca su Test: riceverai un messaggio di prova istantaneo sul tuo telefono.
Da questo momento, se il tuo sito web dovesse smettere di rispondere, Uptime Kuma ti invierà un messaggio entro 60 secondi specificando anche l'errore riscontrato (es. Causa: Errore 502 Bad Gateway o Timeout).
Strategia di Backup dei Dati
Tutti i dati di Uptime Kuma, compresi lo storico dei tempi di attività, i monitor e le configurazioni delle notifiche, sono memorizzati in un database SQLite leggero all'interno della cartella ./data.
Per integrare il backup di Uptime Kuma nel tuo sistema di backup giornaliero, ti basterà aggiungere la cartella /opt/uptime-kuma/data al tuo script di archiviazione notturno. Non essendoci database pesanti come MySQL o PostgreSQL, la copia della cartella a container attivo è sicura e immediata.
Conclusioni
Uptime Kuma è lo strumento essenziale che mancava nel parco software di ogni amministratore di sistema o professionista digitale. Offre una panoramica visiva immediata sullo stato di salute della propria infrastruttura aziendale, azzerando i costi di licenza e garantendo il pieno controllo dei flussi di notifica.