Kutt

Accesso

• Apri URL: https://<SERVER_IP>
• HTTPS usa un certificato autofirmato.
• È previsto un avviso del browser al primo accesso.
• Accetta l'avviso del certificato nel browser.
• Verrai reindirizzato a /create-admin al primo accesso.
• Crea un account amministratore dall'interfaccia web.
• Accedi usando l'account amministratore.

File e directory importanti

• Percorso di installazione: /root/kutt
• File Compose: /root/kutt/docker-compose.yml
• File di ambiente: /root/kutt/.env
• Configurazione Nginx: /etc/nginx/sites-available/kutt
• Certificato SSL: /etc/nginx/ssl/kutt.crt
• Chiave privata SSL: /etc/nginx/ssl/kutt.key
• Volume dati PostgreSQL: /var/lib/docker/volumes/kutt_db_data_pg/_data
• Volume dati Redis: /var/lib/docker/volumes/kutt_redis_data/_data
• Volume dati personalizzato: /var/lib/docker/volumes/kutt_custom/_data

Gestione Docker

Verifica lo stato:

docker compose -f /root/kutt/docker-compose.yml ps

Visualizza i log:

docker compose -f /root/kutt/docker-compose.yml logs -f

Riavvia servizio:

docker compose -f /root/kutt/docker-compose.yml restart

Interrompi servizio:

docker compose -f /root/kutt/docker-compose.yml down

Avvia servizio:

docker compose -f /root/kutt/docker-compose.yml up -d

Gestione NGINX

Configurazione del test:

nginx -t

Riavvia NGINX:

systemctl restart nginx

Ricarica NGINX:

systemctl reload nginx

Verifica lo stato:

systemctl status nginx

Abilitare SSL con un dominio

1. Punta il tuo dominio all'IP del server.

2. Modifica la configurazione Nginx e sostituisci entrambi server_name _; con il tuo dominio (server_name <yourdomain.com>) sia per i blocchi HTTP (porta 80) sia HTTPS (porta 443):

vim /etc/nginx/sites-available/kutt

3. Installa Certbot:

apt install -y certbot python3-certbot-nginx

4. Esegui il seguente comando per generare un certificato Let's Encrypt valido:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Sostituisci i percorsi SSL nella configurazione Nginx:

vim /etc/nginx/sites-available/kutt
# Before:
    # ssl_certificate     /etc/nginx/ssl/kutt.crt;
    # ssl_certificate_key /etc/nginx/ssl/kutt.key;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Ricarica Nginx per applicare le modifiche:

systemctl reload nginx

7. Modifica il /root/kutt/.env file per impostare il nome di dominio: DEFAULT_DOMAIN=yourdomain.com

8. Ricreare i servizi:

cd /root/kutt
docker compose up -d

9. Apri il browser e vai a: https://yourdomain.com