Access Etherpad

User interface: https://<SERVER_IP>
Admin interface: https://<SERVER_IP>/admin
Admin credentials: Username admin, password stored in .env som ADMIN_PASSWORD

Add Users via Admin Settings

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

2. Go to Settings.

3. A JSON configuration file will be displayed.

4. Locate the 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. Add a new user (follow valid JSON syntax):

  "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. Click Save Settings.

7. Click Restart Etherpad.

Vigtige filer og mapper

Installation af programmet: /root/etherpad
Docker Compose-fil: /root/etherpad/docker-compose.yml
Miljøvariabler: /root/etherpad/.env
PostgreSQL database data: /var/lib/docker/volumes/etherpad_postgres_data/_data
Etherpad runtime data: /var/lib/docker/volumes/etherpad_etherpad-var/_data
Plugins directory: /var/lib/docker/volumes/etherpad_plugins/_data
Nginx-konfiguration: /etc/nginx/sites-available/etherpad
SSL-certifikater: /etc/nginx/ssl/

Servicestyring

Listebeholdere:

docker ps

Genstart containere:

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

Follow Etherpad logs:

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

Genstart Nginx:

systemctl restart nginx

Aktivering af SSL med et domæne

1. Peg dit domæne mod serverens IP-adresse.

2. Rediger Nginx-konfigurationen og udskift begge dele server_name <IP>; med dit domæne (<your-domain>) for både HTTP (port 80) og HTTPS (port 443) blokeringer:

vim /etc/nginx/sites-available/etherpad

3. Installer Certbot:

apt install -y certbot python3-certbot-nginx

4. Kør følgende kommando for at generere et gyldigt Let’s Encrypt-certifikat:

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

5. Erstat SSL-stier i Nginx-konfigurationen:

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. Genstart Nginx for at anvende ændringerne:

systemctl restart nginx

7. Åbn din browser og gå til: https://yourdomain.com

Noter

Etherpad is served behind an Nginx reverse proxy for SSL termination and improved security.
A self-signed certificate may trigger browser warnings; this is expected unless Let’s Encrypt is used.
Some browsers may display errors or cause Etherpad to function incorrectly.
Etherpad has been tested and confirmed working on Firefox, which is recommended for best compatibility.

Etherpad

Ansøgningsoplysninger