Etherpad

Toegang tot Etherpad

• Gebruikersinterface: https://<SERVER_IP>
• Beheerinterface: https://<SERVER_IP>/admin
• Beheerdersreferenties: Gebruikersnaam admin, wachtwoord opgeslagen in .env as ADMIN_PASSWORD

Voeg gebruikers toe via beheerdersinstellingen

1. Bezoek: https://<SERVER_IP>/admin

2. Ga naar Instellingen.

3. Er wordt een JSON-configuratiebestand weergegeven.

4. Zoek de users sectie:

  "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. Voeg een nieuwe gebruiker toe (volg de geldige JSON-syntaxis):

  "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. Klik op Instellingen opslaan.

7. Klik op Etherpad opnieuw starten.

Belangrijke bestanden en mappen

• Applicatie-installatie: /root/etherpad
• Docker Compose-bestand: /root/etherpad/docker-compose.yml
• Omgevingsvariabelen: /root/etherpad/.env
• PostgreSQL-databasegegevens: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Etherpad-runtimegegevens: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Directory met plug-ins: /var/lib/docker/volumes/etherpad_plugins/_data
• Nginx-configuratie: /etc/nginx/sites-available/etherpad
• SSL-certificaten: /etc/nginx/ssl/

Servicebeheer

Lijstcontainers:

docker ps

Containers opnieuw starten:

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

Volg Etherpad-logboeken:

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

Start Nginx opnieuw:

systemctl restart nginx

SSL inschakelen met een domein

1. Wijs je domein naar het server-IP.

2. Pas de Nginx-config aan en vervang beide server_name <IP>; met je domein (<your-domain>) voor zowel de HTTP-blokken (poort 80) als de HTTPS-blokken (poort 443):

vim /etc/nginx/sites-available/etherpad

3. Installeer Certbot:

apt install -y certbot python3-certbot-nginx

4. Voer het volgende commando uit om een geldig Let's Encrypt-certificaat te genereren:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Vervang de SSL-paden in de Nginx-config:

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. Herstart Nginx om de wijzigingen door te voeren:

systemctl restart nginx

7. Open je browser en bezoek: https://yourdomain.com

Opmerkingen

• Etherpad wordt bediend achter een Nginx reverse proxy voor SSL-beëindiging en verbeterde beveiliging.
• Een zelfondertekend certificaat kan browserwaarschuwingen activeren; dit wordt verwacht tenzij Let’s Encrypt wordt gebruikt.
• Sommige browsers kunnen fouten weergeven of ervoor zorgen dat Etherpad niet correct functioneert.
• Etherpad is getest en werkt op Firefox, wat wordt aanbevolen voor de beste compatibiliteit.