Etherpad

Accede a Etherpad

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

Añade usuarios desde la configuración de administrador

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

2. Go a Configuración.

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

4. Localiza 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. Añade un nuevo usuario (sigue la sintaxis válida JSON):

  "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 ejecución de Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Directorio de plugins: /var/lib/docker/volumes/etherpad_plugins/_data
• Configuración de Nginx: /etc/nginx/sites-available/etherpad
• Certificados SSL: /etc/nginx/ssl/

Gestión del servicio

Listar contenedores:

docker ps

Reiniciar contenedores:

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

Seguir los logs de Etherpad:

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

Reiniciar 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 los dos server_name <IP>; con tu dominio («<your-domain>) para los bloques HTTP (puerto 80) y 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 Let's Encrypt válido:

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 el navegador y visita: https://yourdomain.com

Notas

• Etherpad funciona detrás de un proxy inverso Nginx para la terminación SSL y mayor seguridad.
• Un certificado autofirmado puede generar avisos en el navegador; esto es normal salvo que se use Let's Encrypt.
• Algunos navegadores pueden mostrar errores o provocar que Etherpad no funcione correctamente.
• Etherpad ha sido probado y confirmado en Firefox, que es el navegador recomendado para mayor compatibilidad.