Etherpad

Přístup k Etherpad

• Uživatelské rozhraní: https://<SERVER_IP>
• Adminské rozhraní: https://<SERVER_IP>/admin
• Přihlašovací údaje administrátora: Uživatelské jméno admin, heslo uloženo v .env as ADMIN_PASSWORD

Přidat uživatele přes nastavení administrátora

1. Navštívit: https://<SERVER_IP>/admin

2. Přejděte do Nastavení.

3. Zobrazí se konfigurační soubor JSON.

4. Vyhledejte users sekce:

  "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. Přidejte nového uživatele (dodržujte platnou syntaxi 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. Klikněte na Uložit nastavení.

7. Klikněte na Restartovat Etherpad.

Důležité soubory a adresáře

• Instalace aplikace: /root/etherpad
• Soubor Docker Compose: /root/etherpad/docker-compose.yml
• Proměnné prostředí: /root/etherpad/.env
• Data databáze PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Data běhového prostředí Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Adresář pluginů: /var/lib/docker/volumes/etherpad_plugins/_data
• Konfigurace Nginx: /etc/nginx/sites-available/etherpad
• SSL certifikáty: /etc/nginx/ssl/

Správa služeb

Vypsat kontejnery:

docker ps

Restartovat kontejnery:

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

Sledovat logy Etherpad:

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

Restartovat Nginx:

systemctl restart nginx

Povolení SSL s vlastní doménou

1. Nasměrujte svou doménu na IP adresu serveru.

2. Upravte konfiguraci Nginx a nahraďte obě hodnoty server_name <IP>; svou doménou (<your-domain>) pro bloky HTTP (port 80) i HTTPS (port 443):

vim /etc/nginx/sites-available/etherpad

3. Nainstalujte Certbot:

apt install -y certbot python3-certbot-nginx

4. Spusťte následující příkaz pro vygenerování platného certifikátu Let's Encrypt:

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

5. Nahraďte cesty SSL v konfiguraci 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. Restartujte Nginx, aby se změny projevily:

systemctl restart nginx

7. Otevřete prohlížeč a přejděte na: https://yourdomain.com

Poznámky

• Etherpad běží za reverzní proxy Nginx zajišťující ukončení SSL a vyšší zabezpečení.
• Vlastnoručně podepsaný certifikát může v prohlížeči vyvolat varování - to je očekávané chování, pokud nepoužíváte Let's Encrypt.
• Některé prohlížeče mohou zobrazovat chyby nebo způsobit nesprávné fungování Etherpad.
• Etherpad byl otestován a ověřen jako funkční ve Firefoxu, který je doporučen pro nejlepší kompatibilitu.