Kener

Accès

1. Ouvrez votre navigateur et rendez-vous sur : https://<SERVER_IP>
2. Un avertissement SSL dans le navigateur est normal (certificat auto-signé)
3. Cliquer sur Connexion
4. Créer votre compte administrateur

Fichiers et répertoires importants

• Répertoire d'installation de Kener : /root/kener
• Fichier d'environnement : /root/kener/.env
• Fichier Compose Docker : /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 du service

# 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'adresse IP du serveur.

2. Modifiez /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>; par votre domaine (« <your-domain>) pour 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. 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

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 accédez à : https://yourdomain.com

10. Après vous être connecté, accédez à Site Configuration et mettez à jour le champ Site URL 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 public est défini via ORIGIN in .env (requis pour la protection CSRF)
• Nginx gère le HTTPS et le proxy inverse.
• Une fois votre nom de domaine et votre certificat SSL configurés, mettez à jour l'URL du site Kener pour qu'elle corresponde à votre domaine. Assurez-vous que le domaine et le certificat SSL sont actifs au préalable : mettre à jour l'URL du site avant cela peut entraîner des erreurs.