📍 المقالة الرئيسية: Outline 2026: الدليل الكامل.
ثلاثون دقيقة لتحويل VPS فارغ إلى خادم Outline إنتاج. الطريقة موثقة في عدة شركات إفريقية فرنكوفونية، بتكلفة إجمالية 4.51 يورو/شهرياً لـ 100 مستخدم.
المتطلبات
Hetzner CX22 minimum (2 vCPU، 4 GB RAM). Coolify v4. اسم نطاق DNS A: wiki.votre-entreprise.com. SMTP (Brevo، Resend) للدعوات. المستوى: متوسط. الوقت: 30-45 دقيقة.
الخطوة 1 — DNS و MinIO
أنشئ DNS A: wiki.votre-entreprise.com → IP الـ VPS. MinIO يمكن نشره عبر Coolify أيضاً (Resources → MinIO). Bucket outline مع credentials مدوَّنة.
الخطوة 2 — خدمة Outline في Coolify
Resources → + New → Service → ابحث عن «Outline». Coolify ينشر القالب الرسمي. الاسم: outline-prod.
الخطوة 3 — متغيرات البيئة
SECRET_KEY و UTILS_SECRET أساسية للأمان (32 octets hex). DATABASE_URL يربط Postgres. Storage S3 يستخدم MinIO أو Backblaze B2.
NODE_ENV=production
SECRET_KEY=générer-32-octets-hex
UTILS_SECRET=générer-32-octets-hex
URL=https://wiki.votre-entreprise.com
PORT=3000
DATABASE_URL=postgres://outline:password@outline-db:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://outline-redis:6379
AWS_ACCESS_KEY_ID=minio-access-key
AWS_SECRET_ACCESS_KEY=minio-secret-key
AWS_REGION=us-east-1
AWS_S3_UPLOAD_BUCKET_URL=https://minio.votre-entreprise.com
AWS_S3_UPLOAD_BUCKET_NAME=outline
AWS_S3_FORCE_PATH_STYLE=true
SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_USERNAME=login
SMTP_PASSWORD=clé-api
SMTP_FROM_EMAIL=wiki@votre-entreprise.com
EMAIL_LOGIN=true
DEPLOYMENT=production
الخطوة 4 — النطاق HTTPS
تبويب Domains: https://wiki.votre-entreprise.com. Force HTTPS ON.
الخطوة 5 — إطلاق Deploy
Coolify يسحب outlinewiki/outline:latest، postgres:16، redis:7. احسب 3-4 دقائق.
الخطوة 6 — أول حساب
افتح https://wiki.votre-entreprise.com. صفحة signup: أدخل email admin. Outline يرسل magic link، انقر للتأكيد. أول حساب = admin workspace.
الخطوة 7 — أول collection
Sidebar → New Collection → اسم (Engineering)، وصف، أيقونة، لون. الصلاحيات: Members (الفريق كاملاً)، Restricted. أنشئ عدة: Engineering، Marketing، Onboarding، Legal.
الخطوة 8 — دعوة الأعضاء
Settings → Members → Invite people. Admin/Member/Viewer.
الخطوة 9 — تكوين SSO
Settings → Authentication → OIDC. راجع SSO Authentik.
الخطوة 10 — النسخ الاحتياطية
# Cron يومي
docker exec outline-db pg_dump -U outline outline | gzip > /tmp/outline-pg.gz
mc mirror minio/outline /backup/outline-files/
restic backup /tmp/outline-pg.gz /backup/outline-files
rm -f /tmp/outline-pg.gz
الأخطاء الشائعة
| الخطأ | الحل |
|---|---|
| Upload صور يفشل | AWS_S3_FORCE_PATH_STYLE=true لـ MinIO |
| Email magic link غير مستلم | SMTP غير مختبر |
| WebSocket متأخر | Caddy لا يُحوِّل WS |
| Migration loop | postgres:16 إجباري |
التكيف مع السياق
SMTP موثوق (Brevo، Resend). MinIO محلي على نفس VPS أو Hetzner Storage Box. النسخ الاحتياطية كل 6 ساعات إلزامية.
دروس الإخوة
الأسئلة المتكررة
السعة CX22؟ 100 مستخدم + 10k مستند.
Maintenance؟ 30 دقيقة شهرياً.