Come installare la pagina di stato Cachet su un server Ubuntu 24.04

Cachet è un sistema di pagina di stato open-source scritto in PHP. Ti consente di monitorare i tempi di inattività e i guasti del sistema sulla tua infrastruttura. Cachet fornisce API JSO, report, metriche, metodi di notifica multipli e autenticazione a due fattori.

In questo tutorial, imparerai come installare e far funzionare Cachet su un server Ubuntu 24.04 con Docker. Installerai anche e configurerai Nginx come reverse proxy e proteggerai Cachet con HTTPS tramite Certbot e Letsencrypt.

Prerequisiti

Per completare questa guida, assicurati di avere:

• Un server Ubuntu 24.04.
• Un utente non root con privilegi di amministratore.
• Un nome di dominio puntato all’indirizzo IP del server.

Installazione di Docker Engine

In questa guida, eseguirai Cachet come un contenitore utilizzando Docker. Installerai quindi Docker Engine sul tuo sistema Ubuntu.

Per prima cosa, esegui il comando qui sotto per installare i pacchetti ca-certificates e curl.

sudo apt install ca-certificates curl

Ora esegui il seguente comando per aggiungere la chiave GPG per il repository Docker.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

Aggiungi il repository Docker con il seguente:

echo  
“deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu  
(. /etc/os-release && echo "VERSION_CODENAME") stable" |  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Successivamente, aggiorna l’indice dei pacchetti di Ubuntu e installa Docker Engine con il seguente comando apt. Inserisci Y per confermare l’installazione.

sudo apt update  
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Dopo l’installazione, il servizio docker dovrebbe essere in esecuzione e abilitato sul tuo sistema Ubuntu.

Esegui il comando qui sotto per controllare il servizio Docker.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Vedrai un output simile qui sotto:

Configurazione dell’utente per eseguire Docker

Dopo aver installato Docker, devi aggiungere il tuo utente al gruppo docker. Questo ti consente di eseguire il contenitore come utente non root.

Per aggiungere il tuo utente al gruppo docker, esegui il comando qui sotto. Cambia il nome utente con il tuo utente.

sudo usermod -aG docker username

Ora accedi con il tuo utente ed esegui il comando docker per verificare la tua configurazione.

su - username  
docker run hello-world

Se la tua configurazione ha avuto successo, vedrai il messaggio Hello World di Docker.

Installazione di Cachet con Docker

Ora che hai installato Docker Engine e configurato il tuo utente, scaricherai il progetto Cachet, configurerai il file docker-compose.yml, costruirai le immagini e riconfigurerai il contenitore per Cachet, e poi eseguirai Cachet come un contenitore.

Scarica la versione docker di Cachet nella directory cachet-docker e spostati in essa.

git clone https://github.com/cachethq/Docker.git cachet-docker  
cd cachet-docker

Modifica il docker-compose.yml utilizzando l’editor nano.

nano docker-compose.yml

Cambia la porta predefinita in 8000 sia per il contenitore che per l’host Docker.

ports:  
 - 8000:8000

Salva il file ed esci.

Ora esegui il comando docker qui sotto per costruire l’immagine di Cachet e avviare il contenitore di Cachet.

docker compose build  
docker compose up

Durante il processo di costruzione, vedrai quanto segue:

Quando avvii il contenitore di Cachet, riceverai un output simile al seguente:

La prima volta che esegui Cachet, genererà una nuova APP_KEY come la seguente - Copia l’APP_KEY e premi Ctrl+c per terminare i contenitori di Cachet.

Successivamente, modifica di nuovo il file docker-compose.yml e sostituisci l’APP_KEY come segue:

APP_KEY=base64:6ltZ62B69p6oxIVeQtf9jpX5BFvgUXU2qk5eXpw3OIQ=

Salva il file ed esci.

Ora esegui il comando docker qui sotto per eliminare i vecchi contenitori e i nuovi contenitori di Cachet.

docker compose down  
docker compose up -d

Infine, esegui il seguente comando per controllare i contenitori o i servizi in esecuzione.

docker compose ps

Puoi vedere qui sotto che il contenitore di Cachet è in esecuzione sulla porta 8000.

Configurazione di Nginx come reverse proxy

In questa guida, eseguirai Cachet con Nginx come reverse proxy. Quindi ora installerai Nginx e un nuovo blocco server per un reverse proxy. Assicurati di avere il tuo nome di dominio pronto e puntato all’indirizzo IP del server.

Per installare il server web Nginx, esegui il seguente comando apt. Inserisci Y per procedere con l’installazione.

sudo apt install nginx

Dopo che l’installazione è completata, crea un nuovo file di blocco server Nginx /etc/nginx/sites-available/cachet.conf con l’editor nano.

sudo nano /etc/nginx/sites-available/cachet.conf

Incolla la seguente configurazione e assicurati di cambiare status.howtoforge.local con il tuo nome di dominio.

server {  
 listen 80;  
 server_name status.howtoforge.local;  
 location / {  
 proxy_pass http://127.0.0.1:8000;  
 proxy_set_header Host $host;  
 proxy_set_header X-Real-IP $remote_addr;  
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
 proxy_set_header X-Forwarded-Proto $scheme;  
 }  
}

Quando hai finito, salva il file ed esci dall’editor.

Ora esegui il comando qui sotto per attivare il file di blocco server cachet.conf e verificare la sintassi di Nginx. Se hai una sintassi corretta, vedrai un output test- è riuscito - sintassi ok.

sudo ln -s /etc/nginx/sites-available/cachet.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Infine, esegui il comando systemctl qui sotto per riavviare il servizio Nginx e applicare le tue modifiche. Quindi, controlla lo stato del servizio Nginx per assicurarti che sia in esecuzione.

sudo systemctl restart nginx  
sudo systemctl status nginx

Puoi vedere qui sotto che il servizio Nginx è in esecuzione come reverse proxy per l’installazione di Cachet.

Proteggere Cachet con HTTPS

A questo punto, Cachet è in esecuzione in un contenitore e hai configurato Nginx come reverse proxy per esso. Per proteggere Cachet, genererai certificati SSL e implementerai HTTPS tramite Certbot e Letsencrypt.

Installa Certbot e il plugin Certbot Nginx utilizzando il seguente comando apt. Premi Y per confermare l’installazione.

sudo apt install certbot python3-certbot-nginx

Ora esegui il comando certbot qui sotto per generare certificati SSL e proteggere Cachet con HTTPS. Assicurati di cambiare il nome di dominio e l’indirizzo email con le tue informazioni.

sudo certbot --nginx

Una volta completato il processo, i tuoi certificati SSL saranno disponibili nella directory /etc/letsencrypt/live/domain.com e la tua installazione di Cachet dovrebbe essere protetta con HTTPS.

Installazione di Cachet

Visita il tuo nome di dominio Cachet come https://status.howtoforge.local/ utilizzando il tuo browser web preferito. vedrai la procedura guidata di installazione.

Nella sezione Configurazione dell’ambiente, seleziona Cache, Queue e Session predefiniti come Database e inserisci i tuoi dettagli SMTP.

Crea la tua prima pagina di stato e fai clic su Avanti per continuare.

Inserisci il nuovo utente amministratore, l’indirizzo email e la password per la tua installazione di Cachet.

Dopo che l’installazione è terminata, vedrai un output Cachet è stato configurato con successo. E poi fai clic su Vai al dashboard per accedere a Cachet.

Inserisci il tuo utente admin e la password, quindi fai clic su Accesso.

Se hai le credenziali corrette, vedrai il dashboard di Cachet come il seguente:

Conclusione

Congratulazioni! Hai completato l’installazione della pagina di stato Cachet su un server Ubuntu 24.04 con Docker. Hai configurato Nginx come reverse proxy per Cachet e protetto Cachet con HTTPS tramite Certbot e Letsencrypt. Ora puoi aggiungere e monitorare i tuoi siti web o servizi con Cachet e impostare ulteriori notifiche con indirizzi email ecc.