Access Etherpad

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

Önemli Dosyalar ve Dizinler

Application installation: /root/etherpad
Docker Compose dosyası: /root/etherpad/docker-compose.yml
Çevre değişkenleri: /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
Nginx yapılandırması: /etc/nginx/sites-available/etherpad
SSL sertifikaları: /etc/nginx/ssl/

Hizmet Yönetimi

Konteynerleri listele:

docker ps

Konteynerleri yeniden başlat:

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

Follow Etherpad logs:

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

Nginx'i yeniden başlatın:

systemctl restart nginx

Bir Etki Alanı ile SSL'yi Etkinleştirme

1. Alan adınızı sunucu IP adresine yönlendirin.

2. Nginx yapılandırmasını düzenleyin ve her ikisini de değiştirin server_name <IP>; alan adınızla (<your-domain>) hem HTTP (bağlantı noktası 80) hem de HTTPS (bağlantı noktası 443) blokları için:

vim /etc/nginx/sites-available/etherpad

3. Certbot'u yükleyin:

apt install -y certbot python3-certbot-nginx

4. Geçerli bir Let’s Encrypt sertifikası oluşturmak için aşağıdaki komutu çalıştırın:

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

5. Nginx yapılandırmasında SSL yollarını değiştirin:

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. Değişiklikleri uygulamak için Nginx'i yeniden başlatın:

systemctl restart nginx

7. Tarayıcınızı açın ve şu adresi ziyaret edin: https://yourdomain.com

Notlar

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

Başvuru Detayları