Etherpad

Akses Etherpad

• Antarmuka pengguna https://<SERVER_IP>
• Interface admin: https://<SERVER_IP>/admin
• Kredensial admin: Username admin, password disimpan di .env as ADMIN_PASSWORD

Tambah Pengguna melalui Pengaturan Admin

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

2. Buka Pengaturan.

3. File konfigurasi JSON akan ditampilkan.

4. Temukan bagian users bagian:

  "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. Tambahkan pengguna baru (ikuti sintaks JSON yang valid):

  "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. Klik Save Settings.

7. Klik Restart Etherpad.

File dan Direktori Penting

• Instalasi aplikasi: /root/etherpad
• File Docker Compose: /root/etherpad/docker-compose.yml
• Variabel lingkungan: /root/etherpad/.env
• Data database PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Data runtime Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Direktori plugin: /var/lib/docker/volumes/etherpad_plugins/_data
• Konfigurasi Nginx: /etc/nginx/sites-available/etherpad
• Sertifikat SSL: /etc/nginx/ssl/

Manajemen Layanan

Daftar kontainer:

docker ps

Mulai ulang kontainer:

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

Ikuti log Etherpad:

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

Mulai ulang Nginx:

systemctl restart nginx

Mengaktifkan SSL dengan Domain

1. Arahkan domain kamu ke IP server.

2. Edit konfigurasi Nginx dan ganti kedua server_name <IP>; dengan domainmu (<your-domain>) untuk blok HTTP (port 80) dan HTTPS (port 443):

vim /etc/nginx/sites-available/etherpad

3. Install Certbot:

apt install -y certbot python3-certbot-nginx

4. Jalankan perintah berikut untuk membuat sertifikat Let’s Encrypt yang valid:

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

5. Ganti path SSL di konfigurasi 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. Restart Nginx untuk menerapkan perubahan:

systemctl restart nginx

7. Buka browser dan kunjungi: https://yourdomain.com

Catatan

• Etherpad dijalankan di balik reverse proxy Nginx untuk terminasi SSL dan keamanan yang lebih baik.
• Sertifikat self-signed dapat memicu peringatan browser; ini adalah hal yang wajar kecuali Let's Encrypt digunakan.
• Beberapa browser mungkin menampilkan error atau menyebabkan Etherpad tidak berfungsi dengan benar.
• Etherpad telah diuji dan dikonfirmasi berjalan dengan baik di Firefox, yang direkomendasikan untuk kompatibilitas terbaik.