Accéder à HedgeDoc
- Ouvrez l'interface web HedgeDoc :
https://<SERVER-IP> - Un avertissement du navigateur s'affichera car un certificat auto-signé est utilisé. Continuez vers le site pour poursuivre.
- Cliquez sur 'Se connecter' puis sur 'S'inscrire' pour créer votre compte.
Points de terminaison
- Application principale :
https://<SERVER-IP>/(interface web) - Statut :
https://<SERVER-IP>/status(page de vérification de l'état) - Métriques :
https://<SERVER-IP>/metrics(métriques système) - WebSocket :
/socket.io/(communication en temps réel)
Inscription
L'inscription des utilisateurs est activée par défaut.
Pour désactiver l'inscription de nouveaux utilisateurs, modifiez CMD_ALLOW_EMAIL_REGISTER=true to CMD_ALLOW_EMAIL_REGISTER=false in /root/hedgedoc/.env.
Redémarrez l'application pour appliquer la modification :
cd /root/hedgedoc
docker compose restart
Sauvegarde de la base de données
Créez une sauvegarde PostgreSQL :
cd /root/hedgedoc
docker compose exec database pg_dump hedgedoc -U hedgedoc > backup.sql
Fichiers et répertoires importants
- Chemin d'installation :
/root/hedgedoc - Fichier Compose :
/root/hedgedoc/docker-compose.yml - Fichier d'environnement :
/root/hedgedoc/.env - Config Nginx :
/etc/nginx/sites-available/hedgedoc - Certificat SSL :
/etc/nginx/ssl/hedgedoc.crt - Clé SSL :
/etc/nginx/ssl/hedgedoc.key - Volume des téléversements :
/var/lib/docker/volumes/hedgedoc_uploads/_data - Volume de la base de données :
/var/lib/docker/volumes/hedgedoc_database/_data
Gestion de Docker
Vérifier les conteneurs :
docker ps
Voir les logs :
cd /root/hedgedoc
docker compose logs -f
Redémarrer les services :
cd /root/hedgedoc
docker compose restart
Arrêter les services :
cd /root/hedgedoc
docker compose down
Démarrer les services :
cd /root/hedgedoc
docker compose up -d
Gestion NGINX
Configuration de test :
nginx -t
Redémarrer NGINX :
systemctl restart nginx
Recharger NGINX :
systemctl reload nginx
Vérifier le statut NGINX :
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/hedgedoc
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/hedgedoc
# Before:
# ssl_certificate /etc/nginx/ssl/hedgedoc.crt;
# ssl_certificate_key /etc/nginx/ssl/hedgedoc.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/hedgedoc/.env pour définir votre nom de domaine : CMD_DOMAIN=yourdoamin.com
8. Recréez les services :
cd /root/hedgedoc
docker compose up -d
9. Ouvrez votre navigateur et allez sur : https://yourdomain.com
