Outline

קבצים מוכנים להפעלה

רמת תמיכה נתמך

תבנית Compose מהמקורות הרשמיים; עוד לא נבדקה בהרצה.

צור docker-compose

שדרוג וחזרה לאחור

איך עוברים לגרסה חדשה בבטחה, ואיך חוזרים אחורה אם משהו נכשל.

קודם גיבוי

‏pg_dump של מסד outline, עותק של ה-volume של הקבצים המצורפים (‎/var/lib/outline/data), וה-.env עם SECRET_KEY. [15][27]

שלבי השדרוג

1. גבו את מסד הנתונים (ואת ה-volume של הקבצים המצורפים) לפני כל שדרוג. [2][27]
2. עדכנו את ה-tag המוצמד של outlinewiki/outline ב-docker-compose.yml, ואז הריצו docker compose pull ו-docker compose up -d. [2]נגזרהתיעוד אומר לעדכן את docker-compose.yml לגרסה החדשה ולהריץ את הקונטיינר; ‏pull ו-up -d הם הדרך שבה Compose מחיל tag חדש.
3. ה-migrations של מסד הנתונים רצים אוטומטית כשהקונטיינר החדש עולה; עקבו אחרי הלוגים עד ש-‎/_health עונה OK. [2][6]

חזרה לאחור

ה-migrations לא תמיד תואמים לאחור, ולכן חזרה לגרסה קודמת היא עצירת ה-stack, שחזור ה-dump של מסד הנתונים מלפני השדרוג, והפעלה מחדש של ה-tag הישן. [27]נגזרמדריך הגיבויים מזהיר שה-migrations של גרסאות לא תמיד תואמים לאחור; ‏Outline לא מתעד דרך להחזיר migrations ב-Docker, ולכן השחזור הוא ה-rollback.

מגבלות

• אין התחברות בסיסמה: כולם מתחברים דרך ספק חיצוני. התבנית מחברת ספק OIDC כללי (Keycloak, ‏Authentik, ‏Authelia, ‏GitLab ואחרים); ‏Google, ‏Slack, ‏Microsoft או Discord דורשים משתנים משלהם, וקישורי קסם במייל דורשים SMTP (האפשרות smtp). [3][13][24][25]
• הרישיון הוא Business Source License 1.1, ולא רישיון קוד פתוח. ה-Additional Use Grant שלו מתיר כל שימוש, כולל שימוש בייצור לצוות שלכם, חוץ מהצעת "Document Service" מסחרי שבו צדדים שלישיים יוצרים צוותים ומסמכים משלהם. כל גרסה עוברת ל-Apache 2.0 ארבע שנים אחרי שחרורה (‏1.11.0 ב-12.10.2030). ‏SAML, יומן ביקורת ויכולות נוספות דורשים רישיון בתשלום. [22][23][29]
• תהליך Node אחד מגיש הכול: בלי REDIS_COLLABORATION_URL, ה-collaboration מגביל את Outline לתהליך יחיד, שלפי התיעוד מתאים לצוותים של פחות מכ-1000 משתמשים פעילים. הרחבה דורשת שירות collaboration נפרד, שהתבנית לא מוסיפה. [26][31]
• קבצים מצורפים נשמרים על ה-volume המקומי (בלי S3), עד 250 MB לקובץ כפי שהוגדר בתבנית. ‏Outline חוסם כברירת מחדל בקשות לכתובות ברשת פרטית, ולכן ספק OIDC שמותקן ברשת המקומית צריך את כתובת ה-IP שלו ב-ALLOWED_PRIVATE_IP_ADDRESSES. [3][15][19]

אבטחה

• הגישו את Outline רק ב-HTTPS, דרך reverse proxy שמעביר WebSockets: בלעדיהם אי אפשר לערוך מסמכים. מאחורי ה-proxy התבנית מגדירה את URL ל-https://<domain> ומשאירה את FORCE_HTTPS פעיל. [12][16][19]
• האדם הראשון שמתחבר יוצר את סביבת העבודה והופך למנהל שלה, ואחר כך כל מי שספק ה-OIDC מאשר יכול להצטרף כחבר. התחברו מיד אחרי ההפעלה הראשונה, ואז הגבילו את הגישה ב-Settings (דומיינים מותרים של מייל, או חובת הזמנה), או הגבילו בספק מי רשאי להשתמש ב-client. [33][34]
• ‏SECRET_KEY מצפין נתונים במסד הנתונים. אובדן או החלפה שלו הופכים את הנתונים האלה לבלתי קריאים; ההתאוששות היחידה היא סקריפט שמוחק נתונים מוצפנים כמו sessions, ‏access tokens ואינטגרציות. [4][19][27]
• ‏rate limiter פעיל כברירת מחדל (1000 בקשות ל-IP בדקה, ומחמיר יותר בנקודות קצה רגישות); השאירו אותו פעיל כש-Outline חשוף לאינטרנט. [3][28]

גיבוי

• גבו את PostgreSQL מדי יום ושמרו גיבויים של חודש, כפי שהתיעוד ממליץ, ועוד dump לפני כל שדרוג: המסמכים, הגרסאות, המשתמשים וההגדרות נשמרים שם. [27]
• גבו את ה-volume של הקבצים המצורפים (‎/var/lib/outline/data) יחד עם מסד הנתונים: התמונות והקבצים נשמרים שם, לא ב-PostgreSQL. [2][15]
• שמרו את ה-.env (ובעיקר את SECRET_KEY) במנהל סיסמאות או במאגר מוצפן אחר אחרי כל שינוי; בלי SECRET_KEY, הנתונים המוצפנים במסד משוחזר אובדים. ‏Settings → Export נותן עותק נוסף ב-Markdown, ‏HTML או JSON. [19][27]

גרסה אחרונה

הגרסה האחרונה של הפרויקט

Outline 1.11.0 [37]

הפרופיל נבדק מול

Outline 1.11.0

הפרופיל נבדק מול הגרסה האחרונה.

נבדק ב-

14 באוק׳ 2026

מצב

נבדק ב-90 הימים האחרונים

איפה הגרסאות מתפרסמות

תגיות ב-Docker Hub

הגרסאות האחרונות של כל האפליקציות

גרסה

סטטוס הפרופיל

פורסם

נבדק מול גרסה

Outline 1.11.0

גרסת הפרופיל

1.0.0

המספרים אומתו

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

הפרויקט וחלופות

האתר הרשמי

www.getoutline.com

קוד מקור

github.com/outline/outline

חלופות

BookStackWiki.js

מקורות

1. Docker Docs: Control startup order in Compose (pg_isready healthcheck, service_healthy) (תיעוד רשמי · נקרא 11 באוק׳ 2026)
2. Outline hosting docs: Docker (Compose example with outline, redis, postgres:18 at /var/lib/postgresql, https-portal; migrations run on start) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. outline repository: .env.sample at v1.11.0 (URL, PORT 3000, SECRET_KEY hex 32 bytes, UTILS_SECRET, FILE_STORAGE=local, upload max 262144000, PGSSLMODE) (מאגר רשמי · נקרא 14 באוק׳ 2026)
4. outline repository: server/env.ts at v1.11.0 (SECRET_KEY 64 hex chars; DATABASE_HOST/PORT/NAME/USER/PASSWORD; SERVICES default; FORCE_HTTPS; SMTP_*; upload max default 1,000,000 B) (מאגר רשמי · נקרא 14 באוק׳ 2026)
5. outline repository: Dockerfile at v1.11.0 (node:26.3.0-slim, USER nodejs uid 1001, VOLUME /var/lib/outline/data, wget, HEALTHCHECK /_health every 1m, EXPOSE 3000) (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. outline repository: server/main.ts at v1.11.0 (GET /_health checks PostgreSQL and Redis and returns OK; registered before the HTTPS redirect) (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. outline repository: server/services/index.ts at v1.11.0 (services websockets, collaboration, admin, web, worker, cron) (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. outline repository: server/services/cron.ts at v1.11.0 (runs the daily and hourly CronTasks in-process) (מאגר רשמי · נקרא 14 באוק׳ 2026)
9. outline repository: docs/SERVICES.md at v1.11.0 (services chosen with SERVICES; the Docker image runs all production services by default) (מאגר רשמי · נקרא 14 באוק׳ 2026)
10. outline repository: server/storage/database.ts at v1.11.0 (SSL in production unless PGSSLMODE=disable; pool max 5 per process) (מאגר רשמי · נקרא 14 באוק׳ 2026)
11. outline repository: plugins/oidc/server/env.ts at v1.11.0 (OIDC_ISSUER_URL, OIDC_CLIENT_ID with OIDC_CLIENT_SECRET, OIDC_DISPLAY_NAME) (מאגר רשמי · נקרא 14 באוק׳ 2026)
12. outline repository: server/services/web.ts at v1.11.0 (FORCE_HTTPS redirect honours X-Forwarded-Proto when PROXY_HEADERS_TRUSTED) (מאגר רשמי · נקרא 14 באוק׳ 2026)
13. Outline hosting docs: OIDC (automatic discovery with OIDC_ISSUER_URL, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET; Keycloak, Authentik, Authelia examples) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
14. Outline hosting docs: SMTP (needed for invite and notification emails and for email magic-link sign-in; SMTP_HOST, SMTP_PORT, SMTP_SECURE) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
15. Outline hosting docs: File storage (FILE_STORAGE=local, a Docker volume at /var/lib/outline/data, chown 1001 for bind mounts; S3 alternative) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
16. Outline hosting docs: SSL (always serve over HTTPS; a reverse proxy must forward WebSockets) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
17. Outline hosting docs: Redis (a single Redis server via REDIS_URL, e.g. redis://redis:6379) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
18. Outline hosting docs: Scheduled jobs (cleanup, reminders and trash removal need daily and hourly runs; cron.daily / cron.hourly with UTILS_SECRET) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
19. Outline hosting docs: Troubleshooting (FORCE_HTTPS=false for plain HTTP, WebSockets required, lost SECRET_KEY, ALLOWED_PRIVATE_IP_ADDRESSES) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
20. redis/docker-library-redis v7.4.11: debian Dockerfile (redis uid/gid 999, VOLUME /data, EXPOSE 6379, redis-cli) (מאגר רשמי · נקרא 14 באוק׳ 2026)
21. Outline hosting docs: Requirements (PostgreSQL 14+, Redis 4+, at least 512 MB of memory, 1 GB or more recommended depending on users; an authentication provider) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
22. Outline hosting docs: License restrictions (BSL community edition; selling, reselling or hosting Outline as a service ends the license) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
23. outline repository: LICENSE at v1.11.0 (BSL 1.1; Additional Use Grant: any use except a commercial Document Service for third parties; Change Date 2030-10-12 to Apache 2.0) (מאגר רשמי · נקרא 14 באוק׳ 2026)
24. Outline hosting docs: Authentication (SSO, OIDC and SAML depending on edition; no native email + password sign-in) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
25. Outline hosting docs: Email magic link (enabled when SMTP is set up and email sign-in is allowed in Settings) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
26. Outline hosting docs: Horizontal scaling (single collaboration process fits teams under ~1000 active users; REDIS_COLLABORATION_URL for more) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
27. Outline hosting docs: Backups (daily Postgres backups kept a month, back up before every upgrade, keep the .env with SECRET_KEY, export from Settings) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
28. Outline hosting docs: Rate limiter (enabled by default; 1000 requests per IP per 60 s globally) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
29. Outline hosting docs: Business + Enterprise (paid license and outlinewiki/outline-enterprise image for SAML, audit log and more) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
30. Outline: Pricing (hosted cloud plans and self-hosted licenses) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
31. outline repository: server/index.ts at v1.11.0 (one process when collaboration runs without REDIS_COLLABORATION_URL) (מאגר רשמי · נקרא 14 באוק׳ 2026)
32. outline repository: server/utils/startup.ts at v1.11.0 (V8 heap set to ~80% of a container memory limit, at least 256 MB) (מאגר רשמי · נקרא 14 באוק׳ 2026)
33. outline repository: server/commands/accountProvisioner.ts at v1.11.0 (the user who creates a new workspace gets the Admin role) (מאגר רשמי · נקרא 14 באוק׳ 2026)
34. outline repository: server/commands/userProvisioner.ts at v1.11.0 (new SSO users join unless invites are required or their domain is not allowed) (מאגר רשמי · נקרא 14 באוק׳ 2026)
35. outline repository: CleanupDeletedDocumentsTask.ts at v1.11.0 (documents in the trash are destroyed after 30 days) (מאגר רשמי · נקרא 14 באוק׳ 2026)
36. Docker Hub manifest of outlinewiki/outline:1.11.0 (linux/amd64): 303,766,972 B compressed; 14 layers decompressed and counted: 1,154,121,728 B (מדידה · נקרא 14 באוק׳ 2026)
37. Docker Hub: outlinewiki/outline tags (newest stable 1.11.0, 2026-10-12, same digest as latest; nightly tags besides) (מאגר רשמי · נקרא 14 באוק׳ 2026)
38. Docker: the containerd image store keeps image layers both compressed and uncompressed (תיעוד רשמי · נקרא 14 באוק׳ 2026)
39. Docker Hub: library/redis tag 7.4.11 (linux/amd64 45,896,305 B compressed) (מאגר רשמי · נקרא 14 באוק׳ 2026)
40. redis/docker-library-redis v7.4.11: debian docker-entrypoint.sh (chown, then setpriv to redis) (מאגר רשמי · נקרא 14 באוק׳ 2026)
41. docker-library/postgres: 18/trixie Dockerfile (postgres uid/gid 999, VOLUME /var/lib/postgresql) (מאגר רשמי · נקרא 14 באוק׳ 2026)
42. docker-library/postgres: 18/trixie docker-entrypoint.sh (chown PGDATA, then gosu postgres) (מאגר רשמי · נקרא 14 באוק׳ 2026)
43. PostgreSQL 18 documentation: 19.4 Resource Consumption (תיעוד רשמי · נקרא 10 באוק׳ 2026)
44. PostgreSQL 18 documentation: 19.3 Connections and Authentication (תיעוד רשמי · נקרא 10 באוק׳ 2026)
45. PostgreSQL 18 documentation: 19.10 Vacuuming (autovacuum settings) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
46. PostgreSQL 18 documentation: 19.5 Write Ahead Log (max_wal_size) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
47. PostgreSQL 18 documentation: 51.2 How Connections Are Established (תיעוד רשמי · נקרא 10 באוק׳ 2026)
48. Docker Official Image postgres: documentation (docker-library/docs) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
49. Docker Hub: library/postgres tag 18.6 (compressed image sizes) (מאגר רשמי · נקרא 10 באוק׳ 2026)