Etherpad

Acceder a Ethernet

• Interfaz de usuario: https://<SERVER_IP>
• Interfaz de administración: https://<SERVER_IP>/admin
• Credenciales de administrador: nombre de usuario admin, contraseña almacenada en .env as ADMIN_PASSWORD

Agregar usuarios a través de la configuración de administrador

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

2. Vaya a Configuración.

3. Se mostrará un archivo de configuración JSON.

4. Ubique el users sección:

  "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. Agregue un nuevo usuario (siga la sintaxis JSON válida):

  "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. Haz clic en Guardar configuración.

7. Haz clic en Reiniciar Etherpad.

Archivos y directorios importantes

• Instalación de la aplicación: /root/etherpad
• Archivo Docker Compose: /root/etherpad/docker-compose.yml
• Variables de entorno: /root/etherpad/.env
• Datos de la base de datos PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Datos de tiempo de ejecución de Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Directorio de complementos: /var/lib/docker/volumes/etherpad_plugins/_data
• Configuración de Nginx: /etc/nginx/sites-available/etherpad
• Certificados SSL: /etc/nginx/ssl/

Gestión de servicios

Lista de contenedores:

docker ps

Reiniciar contenedores:

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

Siga los registros de Etherpad:

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

Reinicie Nginx:

systemctl restart nginx

Habilitar SSL con un dominio

1. Apunta tu dominio a la IP del servidor.

2. Edita la configuración de Nginx y reemplaza ambos server_name <IP>; con tu dominio (<your-domain>) tanto para los bloques HTTP (puerto 80) como HTTPS (puerto 443):

vim /etc/nginx/sites-available/etherpad

3. Instala Certbot:

apt install -y certbot python3-certbot-nginx

4. Ejecuta el siguiente comando para generar un certificado válido de Let’s Encrypt:

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

5. Reemplaza las rutas SSL en la configuración de 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. Reinicia Nginx para aplicar los cambios:

systemctl restart nginx

7. Abre tu navegador y visita: https://yourdomain.com

Notas

• Etherpad se sirve detrás de un proxy inverso Nginx para terminación SSL y seguridad mejorada.
• Un certificado autofirmado puede generar advertencias en el navegador; esto es de esperar a menos que se utilice Let's Encrypt.
• Algunos navegadores pueden mostrar errores o hacer que Etherpad funcione incorrectamente.
• Etherpad ha sido probado y confirmado que funciona en Firefox, que se recomienda para una mejor compatibilidad.