Kutt

Accès

• Ouvrir l'URL : https://<SERVER_IP>
• HTTPS utilise un certificat auto-signé.
• Un avertissement du navigateur est normal lors du premier accès.
• Acceptez l'avertissement de certificat du navigateur.
• Vous serez redirigé vers /create-admin lors du premier accès.
• Créez un compte administrateur depuis l'interface web.
• Connectez-vous avec le compte administrateur.

Fichiers et répertoires importants

• Chemin d'installation : /root/kutt
• Fichier Compose : /root/kutt/docker-compose.yml
• Fichier d'environnement : /root/kutt/.env
• Config Nginx : /etc/nginx/sites-available/kutt
• Certificat SSL : /etc/nginx/ssl/kutt.crt
• Clé privée SSL : /etc/nginx/ssl/kutt.key
• Volume de données PostgreSQL : /var/lib/docker/volumes/kutt_db_data_pg/_data
• Volume de données Redis : /var/lib/docker/volumes/kutt_redis_data/_data
• Volume de données personnalisé : /var/lib/docker/volumes/kutt_custom/_data

Gestion de Docker

Vérifier l'état :

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

Voir les logs :

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

Redémarrer le service :

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

Arrêter le service :

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

Démarrer le service :

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

Gestion NGINX

Configuration de test :

nginx -t

Redémarrer NGINX :

systemctl restart nginx

Recharger NGINX :

systemctl reload nginx

Vérifier l'état :

systemctl status nginx

Activer SSL avec un domaine

1. Faites pointer votre domaine vers l'IP du serveur.

2. Modifiez la config Nginx et remplacez les deux server_name _; avec votre domaine (server_name <yourdomain.com>) dans les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/kutt

3. Installez Certbot :

apt install -y certbot python3-certbot-nginx

4. Exécutez la commande suivante pour générer un certificat Let's Encrypt valide :

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

5. Remplacez les chemins SSL dans la config 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. Rechargez Nginx pour appliquer les modifications :

systemctl reload nginx

7. Modifiez le /root/kutt/.env pour définir votre nom de domaine : DEFAULT_DOMAIN=yourdomain.com

8. Recréez les services :

cd /root/kutt
docker compose up -d

9. Ouvrez votre navigateur et allez sur : https://yourdomain.com