Home-Server on FahdLABs | مختّبر فهد

شرح Dockge بالعربي: إدارة Docker Compose بسهولة على Raspberry Pi

Sat, 07 Feb 2026 10:00:00 +0300

هذا الدليل هو نسخة مكتوبة وموسعة من الفيديو:

إذا تستخدم Docker Compose وتبغى إدارة أسهل من التيرمنال، Dockge يعطيك لوحة بسيطة وسريعة بدون تعقيد.

ما هو Dockge؟

Dockge أداة مفتوحة المصدر لإدارة مشاريع docker-compose من واجهة ويب.

تقدر من خلالها:

إنشاء Stack جديد.
تشغيل/إيقاف/تحديث الخدمات.
تعديل compose.yaml مباشرة.
قراءة Logs من نفس الواجهة.

متى يكون Dockge مناسب لك؟

عندك سيرفر واحد أو بيئة منزلية صغيرة.
تستخدم docker-compose بشكل يومي.
تبغى واجهة بسيطة بدون تعقيد أدوات أكبر.

قبل التثبيت

Docker + Docker Compose يجب أن يكونا جاهزين.
يفضل أن يكون الراسبيري باي له IP ثابت.

إذا لم تجهّزها بعد:

1) إنشاء مجلد العمل

1
2


mkdir -p ~/dockge
cd ~/dockge

2) إنشاء ملف compose.yaml لـ Dockge

1

nano compose.yaml

ضع هذا المحتوى:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


services:
 dockge:
 image: louislam/dockge:latest
 container_name: dockge
 restart: unless-stopped
 ports:
 - "5001:5001"
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock
 - ./data:/app/data
 - /full/path/to/folder/stacks:/full/path/to/folder/stacks
 environment:
 - DOCKGE_STACKS_DIR=/full/path/to/folder/stacks

ثم احفظ الملف من خلال الضغط على

ctrl+x
y
enter

ملاحظة مهمة:

لازم المسار الي فيه ال ستاكس يكون مسار كامل مسار الداتا عادي يكون نسبي

نسبي مثل: ./data
كامل مثل: /home/fahdlabs/dockge/stacks
ومسار الستاكس لازم اليمين يكون نفس اليسار
مسار DOCKGE_STACKS_DIR لازم يطابق المسار المربوط في volumes.

3) تجهيز المجلدات المطلوبة

1

mkdir -p data stacks

4) تشغيل Dockge

1

docker compose up -d

تحقق:

1

docker ps

5) فتح الواجهة وإنشاء حساب Admin

من المتصفح:

1

http://RASPBERRY_PI_IP:5001

أول دخول سيطلب إنشاء حساب مدير.

6) إنشاء أول Stack تجريبي (whoami)

من داخل Dockge:

اضغط + Compose.
سمّ الـ Stack: whoami.
ألصق ملف Compose التالي:

1
2
3
4
5
6
7


services:
 whoami:
 image: traefik/whoami
 container_name: whoami
 restart: unless-stopped
 ports:
 - "8080:80"

احفظ.
اضغط Start.

اختبر الخدمة:

1

http://RASPBERRY_PI_IP:8080

ليش whoami؟ لأنها خدمة اختبار خفيفة جدًا وتأكد بسرعة أن مسار Dockge كامل شغال من البداية للنهاية.

7) أهم المميزات العملية في Dockge

Logs: لمتابعة مشاكل التشغيل بسرعة.
Edit: تعديل Compose بدون الرجوع للتيرمنال.
Stop/Start/Restart: إدارة سريعة لكل Stack.
Update: سحب أحدث صورة وإعادة التشغيل.

هيكلة منظمة مقترحة لمشاريعك

داخل ~/dockge/stacks/ اجعل كل خدمة في مجلد مستقل:

دوكجي يسويها لك بهذا الشكل من نفسه

1
2
3
4
5
6
7


stacks/
 adguard/
 compose.yaml
 immich/
 compose.yaml
 uptime-kuma/
 compose.yaml

هذا يسهل النسخ الاحتياطي والمتابعة.

أخطاء شائعة وحلولها

1. `docker: permission denied`

أضف المستخدم لمجموعة docker:

1

sudo usermod -aG docker $USER

ثم أعد تسجيل الدخول.

2. `no such file or directory: compose.yaml`

شغّلت الأمر من مجلد غير صحيح. الحل: ادخل ~/dockge ثم أعد التنفيذ.

3. Stack لا يظهر في Dockge

تأكد أن:

قيمة DOCKGE_STACKS_DIR نفس المسار الكامل الذي اخترته للـ stacks.
مثال صحيح:

1
2
3
4


volumes:
 - /home/USERNAME/dockge/stacks:/home/USERNAME/dockge/stacks
environment:
 - DOCKGE_STACKS_DIR=/home/USERNAME/dockge/stacks

FAQ

هل Dockge بديل كامل لـ Portainer؟

ليس نفس الفلسفة. Dockge أخف ومركز على Docker Compose بشكل مباشر وبسيط.

قاعدة سريعة:

إذا تريد إدارة Compose بسرعة وبشكل واضح: Dockge ممتاز.
إذا تريد إدارة أوسع (Swarm/Features كثيرة): فكر لاحقًا بأدوات أكبر.

هل ينفع على سيرفر واحد منزلي؟

نعم، وهذه أفضل حالة استخدام له.

هل يدعم العربية؟

نعم، يوجد دعم واجهة عربي ويمكن تغييره من الإعدادات.

المصادر الرسمية (للتحديثات)

Dockge Official Website: https://dockge.kuma.pet/
Dockge GitHub: https://github.com/louislam/dockge
Docker Compose Documentation: https://docs.docker.com/compose/

الخلاصة

Dockge يعطيك طريقة سريعة ومرتبة لإدارة docker-compose في الهوم لاب. وهو تجهيز ممتاز قبل تشغيل خدمات مثل AdGuard Home.

إعداد Raspberry Pi 5 من الصفر: تثبيت النظام + SSH + Docker خطوة بخطوة

Sat, 31 Jan 2026 10:00:00 +0300

هذا الدليل هو نسخة مكتوبة وموسعة من الفيديو:

إذا هدفك تحوّل الراسبيري باي إلى سيرفر منزلي (Homelab)، فهذا هو المسار الصحيح للبداية.

لماذا اخترنا Raspberry Pi OS Lite بدل Desktop؟

لأننا نبني سيرفر وليس جهاز استخدام يومي بواجهة رسومية.
نسخة Lite تستهلك RAM أقل، وهذا يعطي موارد أكثر للخدمات مثل Docker.
التحديثات غالبًا أخف وأسرع.
إدارة السيرفر عبر SSH تكفي في أغلب سيناريوهات Homelab.

ماذا ستتعلم في هذا الشرح؟

تفليش نظام Raspberry Pi OS Lite بالطريقة الصحيحة.
تجهيز الإعدادات قبل التشغيل الأول (Wi-Fi + Username + SSH).
الدخول على الجهاز عبر SSH.
تحديث النظام بدون أخطاء شائعة.
تثبيت Docker وDocker Compose وتشغيل أول حاوية للتأكد أن كل شيء يعمل.

المتطلبات

Raspberry Pi 5 (وأي موديل حديث غالبًا يمشي بنفس الخطوات).
بطاقة microSD جيدة.
قارئ بطاقة على الكمبيوتر.
إنترنت.
راوتر منزلي.

1) تنزيل Raspberry Pi Imager وتثبيت النظام

ادخل موقع Raspberry Pi الرسمي وحمّل Raspberry Pi Imager.
افتح البرنامج واختر:

Choose Device: اختر جهازك (مثل Raspberry Pi 5).
Choose OS: اختر Raspberry Pi OS (other) ثم Raspberry Pi OS Lite (64-bit).
Choose Storage: اختر بطاقة الذاكرة الصحيحة.

نسخة Lite مناسبة للسيرفر لأنها أخف من نسخة سطح المكتب.

2) الإعدادات المهمة قبل التفليش (OS Customization)

قبل ما تضغط Write، فعّل هذه الخيارات:

Hostname: مثل fahdlabs.

ملاحظة الهوست نيم تقدر تستخدمه لما تدخل على الباي عن طريق هذا العنوان بدال الايبي: HOSTNAME.local بس تضيف على الاسم الي اخترته “.local”

Username/Password: حساب الدخول.
Configure wireless LAN: إذا كنت تستخدم Wi-Fi.
Set locale settings: المنطقة الزمنية ولوحة المفاتيح.
Enable SSH: واختر Use password authentication.

هذه الخطوة تختصر عليك توصيل شاشة/كيبورد للراسبيري.

3) الإقلاع الأول ومعرفة IP الجهاز

افصل البطاقة من الكمبيوتر.
ركبها في Raspberry Pi وشغّل الجهاز.
انتظر من دقيقة إلى 5 دقائق.
ادخل صفحة الراوتر وابحث عن الجهاز في DHCP clients أو DHCP leases.
انسخ عنوان الـ IP.

4) الدخول عبر SSH

من التيرمنال في جهازك:

1

ssh USERNAME@IP_ADDRESS

مثال:

1

ssh fahad@192.168.1.21

أول مرة سيطلب تأكيد البصمة الأمنية، اكتب:

1

yes

ثم أدخل كلمة المرور.

لو كان hostname.local يعمل عندك، تستطيع الدخول أيضًا بهذه الطريقة:

1

ssh USERNAME@HOSTNAME.local

5) تحديث النظام

بعد تسجيل الدخول:

1
2


sudo apt update
sudo apt upgrade -y

هذه خطوة أساسية قبل تثبيت أي خدمة.

6) تثبيت Docker + Docker Compose

رابط شرح التثبيت من موقع دوكر الرسمي. حسب الطريقة الرسمية على Debian/Raspberry Pi OS:

1
2


curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

بعدها سجّل خروج وادخل مرة ثانية (أو أعد تشغيل الجلسة) لتفعيل صلاحيات مجموعة docker بدون sudo.

تحقق أن Docker يعمل:

1

docker ps

7) اختبار سريع: تشغيل أول حاوية

1

docker run --rm hello-world

إذا ظهرت رسالة النجاح، فـ Docker شغال بشكل صحيح.

الأخطاء الشائعة وحلولها

1. `Permission denied while trying to connect to the Docker daemon`

المشكلة: المستخدم ليس ضمن مجموعة Docker أو لم تُحدّث الجلسة. الحل:

1

sudo usermod -aG docker $USER

ثم أعد تسجيل الدخول.

2. ما أقدر أدخل SSH

تأكد من:

تفعيل SSH في إعدادات Imager.
نفس شبكة الراوتر.
IP صحيح من صفحة الراوتر.

3. الجهاز يعطي IP مختلف بعد كل إعادة تشغيل

هذا طبيعي مع DHCP. الحل الكامل هنا:

شرح تثبيت IP ثابت على Raspberry Pi

FAQ (أسئلة شائعة)

هل لازم Raspberry Pi 5؟

لا. غالبًا نفس الخطوات تمشي على Pi 4 وPi 3 (مع اختلاف الأداء).

هل أستخدم نسخة Desktop أو Lite؟

إذا هدفك سيرفر، استخدم Lite لأنها أخف وأفضل للخدمات.

هل أقدر أبدأ مباشرة بـ Docker مشاريع؟

نعم، وبعدها تقدر تستخدم Dockge لتسهيل إدارة docker-compose:

شرح Dockge كامل

المصادر الرسمية (للتحديثات)

Raspberry Pi Imager: https://www.raspberrypi.com/software/
Raspberry Pi Documentation (Remote Access / SSH): https://www.raspberrypi.com/documentation/computers/remote-access.html
Docker Engine on Debian: https://docs.docker.com/engine/install/debian/
Docker Linux Post-installation: https://docs.docker.com/engine/install/linux-postinstall/

الخلاصة

بهذه الخطوات صار عندك Raspberry Pi جاهز كسيرفر أساسي: دخول عن بعد + نظام محدث + Docker يعمل. هذا الأساس الذي تبني عليه باقي السلسلة.

Home-Server on FahdLABs | مختّبر فهد

شرح Dockge بالعربي: إدارة Docker Compose بسهولة على Raspberry Pi

ما هو Dockge؟

قبل التثبيت

1) إنشاء مجلد العمل

2) إنشاء ملف compose.yaml لـ Dockge

3) تجهيز المجلدات المطلوبة

4) تشغيل Dockge

5) فتح الواجهة وإنشاء حساب Admin

6) إنشاء أول Stack تجريبي (whoami)

7) أهم المميزات العملية في Dockge

هيكلة منظمة مقترحة لمشاريعك

أخطاء شائعة وحلولها

1. docker: permission denied

2. no such file or directory: compose.yaml

3. Stack لا يظهر في Dockge

FAQ

هل Dockge بديل كامل لـ Portainer؟

هل ينفع على سيرفر واحد منزلي؟

هل يدعم العربية؟

المصادر الرسمية (للتحديثات)

الخلاصة

إعداد Raspberry Pi 5 من الصفر: تثبيت النظام + SSH + Docker خطوة بخطوة

لماذا اخترنا Raspberry Pi OS Lite بدل Desktop؟

ماذا ستتعلم في هذا الشرح؟

المتطلبات

1) تنزيل Raspberry Pi Imager وتثبيت النظام

2) الإعدادات المهمة قبل التفليش (OS Customization)

3) الإقلاع الأول ومعرفة IP الجهاز

4) الدخول عبر SSH

5) تحديث النظام

6) تثبيت Docker + Docker Compose

7) اختبار سريع: تشغيل أول حاوية

الأخطاء الشائعة وحلولها

1. Permission denied while trying to connect to the Docker daemon

2. ما أقدر أدخل SSH

3. الجهاز يعطي IP مختلف بعد كل إعادة تشغيل

FAQ (أسئلة شائعة)

هل لازم Raspberry Pi 5؟

هل أستخدم نسخة Desktop أو Lite؟

هل أقدر أبدأ مباشرة بـ Docker مشاريع؟

المصادر الرسمية (للتحديثات)

الخلاصة

1. `docker: permission denied`

2. `no such file or directory: compose.yaml`

1. `Permission denied while trying to connect to the Docker daemon`