الوصول

افتح متصفحك وقم بزيارة: https://<SERVER_IP>

A browser SSL warning is expected due to the self-signed certificate.

Create an admin user by running the following command on the server:

cd /opt/planka && docker compose run --rm planka npm run db:create-admin-user

الملفات والمجلدات المهمة

دليل التثبيت: /opt/planka
ملف Docker Compose: /opt/planka/docker-compose.yml
App data volume: /var/lib/docker/volumes/planka_data/_data
حجم بيانات PostgreSQL: /var/lib/docker/volumes/planka_db-data/_data
Custom terms directory: /opt/planka/terms
Nginx config: /etc/nginx/sites-available/planka
الموقع الممكّن: /etc/nginx/sites-enabled/planka
شهادات SSL: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem

Common Management Commands

cd /opt/planka

# Check running containers
docker ps

# Logs (live)
docker compose logs -f

# Restart services
docker compose restart

# Stop stack
docker compose down

# Start stack
docker compose up -d

تمكين SSL باستخدام نطاق

1. قم بتوجيه نطاقك إلى عنوان IP للخادم.

2. تحرير docker-compose.yml لتعيين نطاقك على BASE_URL: BASE_URL=https://yourdomain.com

3. Restart PLANKA services:

cd /opt/planka/
docker compose up -d

4. قم بتحرير تكوين Nginx واستبدل كلاهما server_name <IP>; مع نطاقك (<yourdomain.com>) لكل من كتل HTTP (المنفذ 80) و HTTPS (المنفذ 443):

vim /etc/nginx/sites-available/planka

5. تثبيت Certbot:

apt install -y certbot python3-certbot-nginx

6. قم بتشغيل الأمر التالي لإنشاء شهادة Let’s Encrypt صالحة:

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

7. استبدال مسارات SSL في ملف تكوين Nginx:

vim /etc/nginx/sites-available/planka
# 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;

8. أعد تشغيل Nginx لتطبيق التغييرات:

systemctl restart nginx

9. افتح متصفحك وانتقل إلى: https://yourdomain.com

PLANKA

تفاصيل الطلب