Access Etherpad

User interface: https://<SERVER_IP>
Admin interface: https://<SERVER_IP>/admin
Admin credentials: Username admin, password stored in .env come 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.

File e directory importanti

Installazione dell'applicazione: /root/etherpad
File Docker Compose: /root/etherpad/docker-compose.yml
Variabili d'ambiente: /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
Configurazione Nginx: /etc/nginx/sites-available/etherpad
Certificati SSL: /etc/nginx/ssl/

Gestione dei servizi

Elenco contenitori:

docker ps

Riavvia i container:

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

Follow Etherpad logs:

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

Riavvia Nginx:

systemctl restart nginx

Abilitazione SSL con un dominio

1. Indirizza il tuo dominio all'IP del server.

2. Modifica la configurazione Nginx e sostituisci entrambi server_name <IP>; con il tuo dominio (<your-domain>) sia per i blocchi HTTP (porta 80) che HTTPS (porta 443):

vim /etc/nginx/sites-available/etherpad

3. Installa Certbot:

apt install -y certbot python3-certbot-nginx

4. Run the following command to generate a valid Let’s Encrypt certificate:

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

5. Sostituire i percorsi SSL nella configurazione 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. Riavvia Nginx per applicare le modifiche:

systemctl restart nginx

7. Apri il browser e visita: https://yourdomain.com

Note

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

Dettagli dell'applicazione