Etherpad

Toegang tot Etherpad

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

Gebruikers toevoegen via de 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 (gebruik 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 herstarten.

Belangrijke bestanden en mappen

• Applicatie-installatie: /root/etherpad
• Docker Compose-bestand: /root/etherpad/docker-compose.yml
• Omgevingsvariabelen: /root/etherpad/.env
• PostgreSQL databasedata: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Etherpad runtimedata: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Pluginsdirectory: /var/lib/docker/volumes/etherpad_plugins/_data
• Nginx-configuratie: /etc/nginx/sites-available/etherpad
• SSL-certificaten: /etc/nginx/ssl/

Servicebeheer

Containers weergeven:

docker ps

Containers opnieuw starten:

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

Bekijk de Etherpad-logs:

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

Nginx opnieuw starten:

systemctl restart nginx

SSL inschakelen met een domein

1. Wijs uw domein toe aan het server-IP.

2. Bewerk de Nginx-configuratie en vervang beide server_name <IP>; door uw domein (<your-domain>) voor zowel het HTTP- (poort 80) als het HTTPS-blok (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-configuratie:

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 toe te passen:

systemctl restart nginx

7. Open je browser en ga naar: https://yourdomain.com

Opmerkingen

• Etherpad draait achter een Nginx reverse proxy voor SSL-afhandeling en betere beveiliging.
• Een zelfondertekend certificaat kan browserwaarschuwingen veroorzaken; dit is normaal tenzij Let's Encrypt wordt gebruikt.
• Sommige browsers kunnen fouten tonen of ervoor zorgen dat Etherpad niet correct werkt.
• Etherpad is getest en werkt correct in Firefox, wat aanbevolen wordt voor de beste compatibiliteit.