Etherpad

Accedi a Etherpad

• Interfaccia utente: https://<SERVER_IP>
• Interfaccia di amministrazione: https://<SERVER_IP>/admin
• Credenziali di amministratore: nome utente admin, password memorizzata in .env as ADMIN_PASSWORD

Aggiungi utenti tramite le impostazioni dell'amministratore

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

2. Vai su Impostazioni.

3. Verrà visualizzato un file di configurazione JSON.

4. Individuare il users sezione:

  "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. Aggiungi un nuovo utente (segui la sintassi JSON valida):

  "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. Fare clic su Salva impostazioni.

7. Fare clic su Riavvia Etherpad.

File e directory importanti

• Installazione dell'applicazione: /root/etherpad
• File Docker Compose: /root/etherpad/docker-compose.yml
• Variabili d'ambiente: /root/etherpad/.env
• Dati del database PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Dati di runtime dell'Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Directory dei plugin: /var/lib/docker/volumes/etherpad_plugins/_data
• Configurazione Nginx: /etc/nginx/sites-available/etherpad
• Certificati SSL: /etc/nginx/ssl/

Gestione del servizio

Elenco contenitori:

docker ps

Riavviare i contenitori:

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

Segui i log di Etherpad:

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

Riavvia Nginx:

systemctl restart nginx

Abilitare SSL con un dominio

1. Punta 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) sia HTTPS (porta 443):

vim /etc/nginx/sites-available/etherpad

3. Installa Certbot:

apt install -y certbot python3-certbot-nginx

4. Esegui il comando seguente per generare un certificato Let's Encrypt valido:

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

5. Sostituisci 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 vai a: https://yourdomain.com

Note

• Etherpad viene servito dietro un proxy inverso Nginx per la terminazione SSL e una maggiore sicurezza.
• Un certificato autofirmato può attivare avvisi del browser; questo è previsto a meno che non venga utilizzato Let's Encrypt.
• Alcuni browser potrebbero visualizzare errori o causare un funzionamento errato di Etherpad.
• Etherpad è stato testato e confermato che funziona su Firefox, che è consigliato per la migliore compatibilità.