Etherpad

Accéder à Etherpad

• Interface utilisateur : https://<SERVER_IP>
• Interface d'administration : https://<SERVER_IP>/admin
• Identifiants administrateur : Nom d'utilisateur admin, mot de passe stocké dans .env as ADMIN_PASSWORD

Ajouter des utilisateurs via les paramètres d'administration

1. Accédez à : https://<SERVER_IP>/admin

2. Go vers Paramètres.

3. Un fichier de configuration JSON s'affichera.

4. Repérez 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. Ajouter un nouvel utilisateur (respecter 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. Cliquer sur Enregistrer les paramètres.

7. Cliquer sur Redémarrer Etherpad.

Fichiers et répertoires importants

• Installation de l'application : /root/etherpad
• Fichier Compose Docker : /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 Nginx : /etc/nginx/sites-available/etherpad
• Certificats SSL : /etc/nginx/ssl/

Gestion du service

Lister les conteneurs :

docker ps

Redémarrer les conteneurs :

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

Suivre les logs Etherpad :

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

Redémarrer Nginx :

systemctl restart nginx

Activer SSL avec un domaine

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

2. Modifiez la configuration Nginx et remplacez les deux occurrences de server_name <IP>; par votre domaine (« <your-domain>) pour les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/etherpad

3. Installer 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 configuration 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 modifications :

systemctl restart nginx

7. Ouvrez votre navigateur et accédez à : https://yourdomain.com

Remarques

• Etherpad est servi derrière un reverse proxy Nginx pour la terminaison SSL et une sécurité renforcée.
• Un certificat auto-signé peut déclencher des avertissements dans le navigateur ; c'est normal sauf si Let's Encrypt est utilisé.
• Certains navigateurs peuvent afficher des erreurs ou empêcher Etherpad de fonctionner correctement.
• Etherpad a été testé et confirmé fonctionnel sur Firefox, qui est recommandé pour une meilleure compatibilité.