Etherpad

Access Etherpad

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

Các tập tin và thư mục quan trọng

• Cài đặt ứng dụng: /root/etherpad
• Tệp Docker Compose: /root/etherpad/docker-compose.yml
• Biến môi trường: /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
• Cấu hình Nginx: /etc/nginx/sites-available/etherpad
• Chứng chỉ SSL: /etc/nginx/ssl/

Quản lý dịch vụ

Liệt kê các loại thùng chứa:

docker ps

Khởi động lại các container:

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

Follow Etherpad logs:

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

Khởi động lại Nginx:

systemctl restart nginx

Kích hoạt SSL với tên miền

1. Trỏ tên miền của bạn đến địa chỉ IP của máy chủ.

2. Chỉnh sửa cấu hình Nginx và thay thế cả hai server_name <IP>; với tên miền của bạn (<your-domain>) cho cả khối HTTP (cổng 80) và HTTPS (cổng 443):

vim /etc/nginx/sites-available/etherpad

3. Cài đặt Certbot:

apt install -y certbot python3-certbot-nginx

4. Chạy lệnh sau để tạo chứng chỉ Let's Encrypt hợp lệ:

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

5. Thay thế đường dẫn SSL trong cấu hình 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. Khởi động lại Nginx để áp dụng các thay đổi:

systemctl restart nginx

7. Mở trình duyệt của bạn và truy cập: https://yourdomain.com

Ghi chú

• 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.