Accéder à Etherpad
- Interface utilisateur :
https://<SERVER_IP> - Interface d'administration :
https://<SERVER_IP>/admin - Identifiants d'administrateur : Nom d'utilisateur
admin, mot de passe stocké dans.envasADMIN_PASSWORD
Ajouter des utilisateurs via les paramètres d'administration
1. Visitez : https://<SERVER_IP>/admin
2. Accédez à Paramètres.
3. Un fichier de configuration JSON s'affichera.
4. Localisez le users section:
"users": {
"admin": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "${ADMIN_PASSWORD:null}",
"is_admin": true
},
"user": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "test",
"is_admin": false
}
},
5. Ajoutez un nouvel utilisateur (suivez la syntaxe JSON valide) :
"users": {
"admin": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "${ADMIN_PASSWORD:null}",
"is_admin": true
},
"user": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "test",
"is_admin": false
},
"newuser": {
"password": "strongpassword",
"is_admin": false
}
},
6. Cliquez sur Enregistrer les paramètres.
7. Cliquez sur Redémarrer Etherpad.
Fichiers et répertoires importants
- Installation des applications :
/root/etherpad - Fichier Docker Compose :
/root/etherpad/docker-compose.yml - Variables d'environnement :
/root/etherpad/.env - Données de la base de données PostgreSQL :
/var/lib/docker/volumes/etherpad_postgres_data/_data - Données d'exécution Etherpad :
/var/lib/docker/volumes/etherpad_etherpad-var/_data - Répertoire des plugins :
/var/lib/docker/volumes/etherpad_plugins/_data - Configuration de Nginx :
/etc/nginx/sites-available/etherpad - Certificats SSL :
/etc/nginx/ssl/
Gestion des services
Répertorier les conteneurs :
docker ps
Redémarrez les conteneurs :
docker compose -f /root/etherpad/docker-compose.yml restart
Suivez les journaux Etherpad :
docker compose -f /root/etherpad/docker-compose.yml logs -f
Redémarrez Nginx :
systemctl restart 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 <IP>; avec votre domaine (<your-domain>) dans les blocs HTTP (port 80) et HTTPS (port 443) :
vim /etc/nginx/sites-available/etherpad
3. Installez Certbot :
apt install -y certbot python3-certbot-nginx
4. Lancez 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/apache2/sites-available/etherpad
# 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;
6. Redémarrez Nginx pour appliquer les changements :
systemctl restart nginx
7. Ouvrez votre navigateur et allez sur : https://yourdomain.com
Remarques
- Etherpad est servi derrière un proxy inverse Nginx pour la terminaison SSL et une sécurité améliorée.
- Un certificat auto-signé peut déclencher des avertissements du navigateur ; ceci est attendu à moins que Let's Encrypt ne soit utilisé.
- Certains navigateurs peuvent afficher des erreurs ou entraîner un dysfonctionnement d'Etherpad.
- Etherpad a été testé et confirmé fonctionnant sur Firefox, ce qui est recommandé pour une meilleure compatibilité.
