Come Self-Hostare Umami su un VPS (Guida Completa)

Umami è una soluzione di analisi web self-hosted che dà priorità alla privacy e alla semplicità. Questa guida ti porterà attraverso il processo di self-hosting di Umami su un Virtual Private Server (VPS) utilizzando Docker, fornendo una guida completa per sviluppatori e appassionati di homelab.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

1. Un VPS attivo da un fornitore affidabile. Ecco un confronto delle opzioni più popolari:

Per confronti dettagliati, visita il nostro confronto completo sui VPS.

2. Conoscenze di base della riga di comando.
3. Un nome di dominio che punta al tuo VPS.
4. Docker e Docker Compose installati.

Passo 1: Configurare il tuo VPS

Per prima cosa, accedi al tuo VPS tramite SSH. Sostituisci username e vps_ip con il tuo nome utente effettivo e l’indirizzo IP del VPS:

ssh username@vps_ip

Aggiorna il tuo indice di pacchetti:

sudo apt update && sudo apt upgrade -y

Passo 2: Installare Docker

Se Docker non è installato, segui questi passaggi:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Verifica l’installazione di Docker:

sudo systemctl status docker

Passo 3: Installare Docker Compose

Docker Compose semplifica la gestione delle applicazioni multi-contenitore. Installalo con:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Controlla la tua installazione:

docker-compose --version

Passo 4: Eseguire Umami

Crea una directory per Umami:

mkdir umami && cd umami

Crea un file docker-compose.yml:

version: '3'

services:
  umami:
    image: umami/umami
    restart: always
    environment:
      DATABASE_URL: postgres://umami:umami_password@db:5432/umami
      NEXT_PUBLIC_USERNAME: admin
      NEXT_PUBLIC_PASSWORD: admin_password
    ports:
      - "3000:3000"

  db:
    image: postgres
    restart: always
    environment:
      POSTGRES_USER: umami
      POSTGRES_DB: umami
      POSTGRES_PASSWORD: umami_password
    volumes:
      - db_data:/var/lib/postgresql/data
    networks:
      - umami-network

volumes:
  db_data:

networks:
  umami-network:

Sostituisci umami_password e admin_password con password forti e uniche.

Passo 5: Avviare Umami

Esegui il seguente comando per avviare Umami:

docker-compose up -d

Conferma che tutti i contenitori siano in esecuzione:

docker-compose ps

Passo 6: Configurare Umami

Accedi a Umami navigando su http://your_domain_or_vps_ip:3000 nel tuo browser. Completa la configurazione aggiungendo i siti da monitorare.

FAQ

Come posso garantire la sicurezza di Umami con HTTPS?

Per garantire la sicurezza della tua installazione di Umami, dovresti configurare un reverse proxy utilizzando Nginx o Traefik per gestire HTTPS tramite Let’s Encrypt. Assicurati che il tuo dominio punti al tuo server, quindi installa il reverse proxy e configura i certificati SSL seguendo la documentazione per Nginx o Traefik.

Posso monitorare più siti web con Umami?

Sì, Umami ti consente di monitorare più siti web dalla stessa dashboard. Basta accedere, fare clic su “Aggiungi un nuovo sito” e seguire le istruzioni per inserire l’URL del tuo sito e altri dettagli pertinenti. Una volta aggiunto, potrai visualizzare le analisi di ciascun sito separatamente dalla tua dashboard di Umami.

Quali sono i requisiti di sistema per eseguire Umami?

Umami non ha requisiti di sistema rigorosi, ma per un’esperienza fluida, si consiglia un VPS con almeno 1 GB di RAM e 1 core CPU. Livelli di traffico più elevati potrebbero richiedere ulteriori risorse, e l’utilizzo di un SSD può migliorare notevolmente le prestazioni.

Conclusione

Self-hostare Umami su un VPS è un processo semplice che ti consente di mantenere il controllo sui tuoi dati di analisi, godendo dei benefici di una potente piattaforma open-source. Con Docker, la configurazione è ancora più accessibile e gestibile. Ora sei pronto per analizzare le prestazioni del tuo sito web senza compromettere la tua privacy. Buon self-hosting!