Immich

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

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

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

צור docker-compose

אפשרויות שמשנות משאבים

machine-learning

הרצת קונטיינר ה-machine learning לחיפוש חכם, זיהוי פנים, כפילויות וטקסט בתמונות. כיבוי חוסך כ-2 GiB של RAM (לפי התיעוד Immich רץ בלעדיו ב-4 GB); אז כבו גם את ה-machine learning ב-Administration > Settings, והחיפוש ועמוד Explore יעבדו פחות טוב.

ברירת מחדל: פעיל

• כשהערך פעיל: Immich machine learning (CPU) +1 vCPU · +2 GiB RAM · +2 GiB דיסק [15][17][18][23][29][35][36]

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

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

קודם גיבוי

צרו קודם dump של מסד הנתונים (Administration > Job Queues > Create Database Dump, או pg_dump של מסד immich) וודאו שיש עותק עדכני של התיקיות library, ‏upload ו-profile ב-volume ההעלאות. [19][21]

שלבי השדרוג

1. קראו את ה-release notes של כל גרסה שאתם מדלגים עליה, ועדכנו קודם את אפליקציות המובייל: השרת עובד רק עם אפליקציות מאותה גרסה ראשית. [21]
2. הגדירו את אותו tag חדש ל-image של השרת ול-image של ה-machine learning; השאירו את ה-image של מסד הנתונים, אלא אם ה-release notes משנים אותו. [2][17][18]נגזר‏upstream מגדיר את שני ה-images מ-IMMICH_VERSION אחד; ה-FAQ מזהיר ששדרוג גרסה ראשית של PostgreSQL הוא יותר מהחלפת image.
3. הריצו docker compose pull && docker compose up -d. ה-migrations רצים בעלייה. [17][21]

חזרה לאחור

שדרוג לאחור לא נתמך, גם לא בתוך אותה גרסה משנית. כדי לחזור, הריצו את ה-tags הישנים על מסד נתונים חדש ושחזרו את ה-dump שנלקח לפני השדרוג (שחזור ב-onboarding או psql), עם אותם קבצים ב-volume ההעלאות. [19][21]

שינויים שוברים ידועים

• בגרסה 3.0.0: קונטיינר ה-machine learning על amd64 דורש מעבד x86-64-v2 (רוב המעבדים מאז 2012 בערך; במכונה וירטואלית בחרו סוג CPU מתאים). השרת עובד רק עם אפליקציות מובייל בגרסה ראשית 3. [15][21]
• בגרסה 2.5.0: הגיבוי והשחזור של מסד הנתונים השתנו: גיבויים מלפני 2.5.0 משוחזרים לפי ההוראות של גרסת התיעוד שלהם. [19]
• בגרסה 1.133.0: ‏VectorChord החליף את pgvecto.rs ב-image של מסד הנתונים. אחרי המעבר אין לחזור לגרסה מתחת ל-1.133.0, ומשחזרים גיבויים חדשים רק ל-image עם VectorChord. [21]

מגבלות

• ‏Immich צריך לפחות 6 GB של RAM ו-2 ליבות (מומלץ 8 GB ו-4 ליבות); בלי machine learning הוא רץ ב-4 GB. על amd64 קונטיינר ה-machine learning דורש מעבד x86-64-v2. [15]
• הגיבוי הראשון של ספרייה גדולה הוא התקופה הכבדה ביותר: תמונות ממוזערות, המרת וידאו ו-jobs של ML רצים לכל פריט. במארחים קטנים הורידו את ה-concurrency של ה-jobs ואת ה-threads של המרת הווידאו; ה-ML רץ כאן על ה-CPU, בלי האצת GPU. [18]
• שמרו את מסד הנתונים על אחסון SSD מקומי, לעולם לא על שיתוף רשת; ספריית התמונות עצמה יכולה לשבת על דיסק גדול. ‏Immich חייב לרוץ בשורש של (תת-)דומיין, לא בתת-נתיב. [15][20]

אבטחה

• הגישו את Immich רק ב-HTTPS דרך reverse proxy שמעביר את הכותרות Host ו-X-Forwarded-*, מעביר WebSockets ומאפשר העלאות גדולות ו-timeouts של 600 שניות. עם תעודת self-signed, העלאות ווידאו באפליקציות המובייל נכשלים לעתים קרובות: השתמשו בתעודה מהימנה. [18][20]
• לעולם אל תחשפו את קונטיינר ה-machine learning, את מסד הנתונים או את Valkey: ל-API של ה-ML אין שום אמצעי אבטחה ול-Valkey אין סיסמה. בתבנית הזו הם מאזינים רק ברשת הפנימית של ה-stack. [17][22]
• המשתמש הראשון שנרשם הופך למנהל. צרו את החשבון הזה מיד אחרי ההפעלה הראשונה, לפני שהכתובת משותפת. [25]

גיבוי

• גבו גם את מסד הנתונים וגם את הקבצים. ‏Immich כותב dump של מסד הנתונים לתיקיית backups ב-volume ההעלאות כל יום ב-02:00 ושומר 14; ה-dumps מכילים רק metadata, אף פעם לא תמונות. [19][24]
• העתיקו את volume ההעלאות בכלי גיבוי משלכם (מומלץ 3-2-1). רק library, ‏upload ו-profile אינם ניתנים לשחזור; את thumbs ו-encoded-video אפשר ליצור מחדש בהרצה חוזרת של ה-jobs. ‏Immich לא מגבה קבצים בעצמו. [19]
• שחזור של מסד הנתונים דורש מסד נתונים חדש ואת אותם קבצים ב-volume ההעלאות כמו בזמן יצירת ה-dump; משחזרים מ-Administration > Maintenance או ממסך ה-onboarding. [19]

גרסה אחרונה

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

Immich 3.3.3 [2][28]נגזר

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

Immich 3.3.3

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

נבדק ב-

14 באוק׳ 2026

מצב

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

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

GitHub Releases

ה-tag היציב החדש ביותר ב-git הוא v3.3.3 ב-14.10.2026 (git ls-remote); ה-docker-compose.yml שלו וה-images של השרת וה-ML בגרסה v3.3.3 קיימים.

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

גרסה

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

פורסם

נבדק מול גרסה

Immich 3.3.3

גרסת הפרופיל

1.0.0

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

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

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

האתר הרשמי

immich.app

קוד מקור

github.com/immich-app/immich

חלופות

PhotoPrismEnte Photos

מקורות

1. Docker Docs: Control startup order in Compose (pg_isready healthcheck, service_healthy) (תיעוד רשמי · נקרא 11 באוק׳ 2026)
2. immich repository: docker/docker-compose.yml at v3.3.3 (server 2283:2283, machine-learning, valkey/valkey:9, ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0, shm_size 128mb) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. immich repository: docker/example.env at v3.3.3 (UPLOAD_LOCATION, DB_DATA_LOCATION, DB_PASSWORD A-Za-z0-9 only, DB_USERNAME postgres, DB_DATABASE_NAME immich) (מאגר רשמי · נקרא 14 באוק׳ 2026)
4. immich repository: server/Dockerfile at v3.3.3 (no USER, VOLUME /data, EXPOSE 2283, HEALTHCHECK immich-healthcheck) (מאגר רשמי · נקרא 14 באוק׳ 2026)
5. immich repository: server/bin/immich-healthcheck at v3.3.3 (curl /api/server/ping on port 2283, expects pong) (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. immich repository: machine-learning/Dockerfile at v3.3.3 (CPU image, no USER, MACHINE_LEARNING_CACHE_FOLDER=/cache, HEALTHCHECK python3 healthcheck.py) (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. immich repository: machine-learning/scripts/healthcheck.py at v3.3.3 (GET /ping on IMMICH_PORT, default 3003) (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. immich repository: server/src/repositories/config.repository.ts at v3.3.3 (IMMICH_TRUSTED_PROXIES defaults to linklocal and uniquelocal) (מאגר רשמי · נקרא 14 באוק׳ 2026)
9. immich-app/base-images: postgres/Dockerfile (pgvector/pgvector base + VectorChord, DB_STORAGE_TYPE=SSD, HEALTHCHECK healthcheck.sh every 5m, start interval 5s) (מאגר רשמי · נקרא 14 באוק׳ 2026)
10. immich-app/base-images: postgres/healthcheck.sh (pg_isready, then fails on any data-checksum failure) (מאגר רשמי · נקרא 14 באוק׳ 2026)
11. immich-app/base-images: postgres/immich-docker-entrypoint.sh (copies the SSD or HDD config, then runs the official docker-entrypoint.sh) (מאגר רשמי · נקרא 14 באוק׳ 2026)
12. Docker Hub: valkey/valkey tag 9.1.2 (linux/amd64 44,768,058 B compressed; the digest pinned upstream is a 9.1.2 build too) (מאגר רשמי · נקרא 14 באוק׳ 2026)
13. valkey-io/valkey-container: 9.1/debian Dockerfile (VALKEY_VERSION 9.1.2, valkey uid/gid 999, WORKDIR /data, EXPOSE 6379, valkey-cli) (מאגר רשמי · נקרא 14 באוק׳ 2026)
14. valkey-io/valkey-container: 9.1/debian docker-entrypoint.sh (chown of /data, then setpriv to valkey) (מאגר רשמי · נקרא 14 באוק׳ 2026)
15. Immich Docs: Requirements (RAM minimum 6 GB, recommended 8 GB; 4 GB with ML disabled; CPU 2 / 4 cores; thumbnails and transcodes +10-20%; database 1-3 GB, at least 2 GB RAM) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
16. Immich Docs: Docker Compose install (recommended production method; start_interval needs Docker Engine v25) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
17. Immich Docs: Environment variables (DB_* and REDIS_* defaults, IMMICH_PORT 2283 / 3003, MACHINE_LEARNING_MODEL_TTL 300 s, DB_STORAGE_TYPE) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
18. Immich Docs: FAQ (disable machine learning; lowering CPU and RAM; 2-3 concurrent ML jobs can max a CPU; non-root user; ML workers out of memory) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
19. Immich Docs: Backup and restore (daily database dumps in UPLOAD_LOCATION/backups, keep 14; back up library, upload and profile; restore from the UI or psql) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
20. Immich Docs: Reverse proxy (forward Host and X-Forwarded-*, WebSockets, large uploads, 600 s timeouts, no sub-path) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
21. Immich Docs: Upgrading (read release notes, docker compose pull && up -d; server only works with mobile apps of its major version; downgrades not supported; VectorChord since 1.133.0) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
22. Immich Docs: Remote machine learning (the ML container has no security measures; it receives image previews and keeps nothing) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
23. Immich Docs: Searching (CLIP models; default ViT-B-32__openai peak RSS 1,004 MiB, measured without acceleration) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
24. Immich Docs: Config file (default ML URL http://immich-machine-learning:3003, CLIP ViT-B-32__openai, faces buffalo_l, OCR PP-OCRv5_mobile, database dump daily 02:00, keep 14) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
25. Immich Docs: Post install (the first user to register becomes the admin) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
26. Immich Docs: System settings (External Domain for shared links and emails) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
27. immich repository: LICENSE at v3.3.3 (GNU AGPL v3) (מאגר רשמי · נקרא 14 באוק׳ 2026)
28. GHCR manifest of ghcr.io/immich-app/immich-server:v3.3.3 (linux/amd64, anonymous token): 611,460,416 B compressed; layers decompressed and counted: 1,731,393,536 B (מדידה · נקרא 14 באוק׳ 2026)
29. GHCR manifest of ghcr.io/immich-app/immich-machine-learning:v3.3.3 (linux/amd64, anonymous token): 271,038,696 B compressed; layers decompressed and counted: 769,134,080 B (מדידה · נקרא 14 באוק׳ 2026)
30. GHCR manifest of ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0 (index digest bcf63357 as pinned upstream; linux/amd64): 205,280,433 B compressed; decompressed 763,875,840 B (מדידה · נקרא 14 באוק׳ 2026)
31. immich-app/base-images: postgres/postgresql.ssd.conf (shared_buffers 512MB, work_mem 16MB, max_wal_size 5GB, wal_compression on) (מאגר רשמי · נקרא 14 באוק׳ 2026)
32. docker-library/postgres: 14/bookworm Dockerfile (postgres uid/gid 999, PGDATA and VOLUME /var/lib/postgresql/data) (מאגר רשמי · נקרא 14 באוק׳ 2026)
33. docker-library/postgres: 14/bookworm docker-entrypoint.sh (chown PGDATA as root, then gosu postgres) (מאגר רשמי · נקרא 14 באוק׳ 2026)
34. PostgreSQL 14 documentation: 20.4 Resource Consumption (dynamic_shared_memory_type posix uses /dev/shm) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
35. Hugging Face: immich-app/ViT-B-32__openai (ONNX textual 254,193,396 B + visual 351,613,724 B) (מאגר רשמי · נקרא 14 באוק׳ 2026)
36. Hugging Face: immich-app/buffalo_l (ONNX detection 16,923,827 B + recognition 174,383,860 B) (מאגר רשמי · נקרא 14 באוק׳ 2026)