Kéner

Accéder

1. Ouvrez votre navigateur et allez sur : https://<SERVER_IP>
2. Un avertissement SSL du navigateur est attendu (certificat auto-signé)
3. Cliquez sur Connexion
4. Créez votre compte administrateur

Fichiers et répertoires importants

• Répertoire d'installation de Kener : /root/kener
• Fichier d'environnement : /root/kener/.env
• Fichier Docker Compose : /root/kener/docker-compose.yml
• Volume de données Redis : /var/lib/docker/volumes/kener_redis/_data
• Volume de données PostgreSQL : /var/lib/docker/volumes/kener_postgres/_data
• Configuration du site Nginx : /etc/nginx/sites-available/kener
• Site activé : /etc/nginx/sites-enabled/kener
• Certificats SSL : /etc/nginx/ssl/fullchain.pem et /etc/nginx/ssl/privkey.pem

Gestion des services

# View logs
docker compose -f /root/kener/docker-compose.yml logs -f

# Restart services
docker compose -f /root/kener/docker-compose.yml restart

# Stop services
docker compose -f /root/kener/docker-compose.yml down

# Start again
docker compose -f /root/kener/docker-compose.yml up -d

Activer SSL avec un domaine

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

2. Modifier /root/kener/.env pour définir votre domaine comme ORIGIN: ORIGIN=https://yourdomain.com

3. Recréez les services :

cd /root/kener/
docker compose up -d

4. Modifiez la configuration Nginx et remplacez les deux server_name <IP>; avec votre domaine (<your-domain>) dans les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/kener

5. Installez Certbot :

apt install -y certbot python3-certbot-nginx

6. Lance 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

7. Remplacez les chemins SSL dans la configuration Nginx :

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

8. Redémarrez Nginx pour appliquer les modifications :

systemctl restart nginx

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

10. Après vous être connecté, accédez à Configuration du site et mettez à jour le champ URL du site pour qu'il corresponde à votre domaine (https://yourdomain.com).

Remarques

• Redis est utilisé pour les files d'attente et la mise en cache
• PostgreSQL stocke toutes les données de l'application
• L'URL publique est définie via ORIGIN in .env (obligatoire pour la protection CSRF)
• Nginx gère HTTPS et le proxy inverse
• Une fois que vous avez configuré un nom de domaine et un certificat SSL appropriés, mettez à jour l'URL du site Kener pour qu'elle corresponde à votre domaine. Assurez-vous que le domaine et SSL sont actifs avant de mettre à jour l'URL du site avant que cela ne fonctionne correctement.