Home Assistant

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

רמת תמיכה התקנה רשמית

אין תבנית Compose של ANAROQ: מתקינים בדרך הרשמית.

למה: קובץ ה-Compose הרשמי מריץ את Home Assistant עם network_mode: host ‏(גילוי mDNS/SSDP ו-integrations שצריכים לראות את רשת הבית) ועם privileged: true ‏(רכיבי USB ו-Bluetooth). שניהם מכוונים, אבל ה-Compose Analyzer של ANAROQ מדרג אותם high ‏(AQ-PRIV-002, ‏AQ-PRIV-001), ו-ANAROQ לא מייצר קובץ כזה; בלעדיהם הגילוי נשבר. השתמשו בקובץ הרשמי.

להתקנה הרשמית של Home Assistant

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

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

קודם גיבוי

גיבוי מלא עם המסד (ברירת המחדל), שמועתק מחוץ לשרת, ועוד ה-emergency kit של הגיבוי: הגיבויים מוצפנים ואי אפשר לשחזר אותם בלי המפתח שבו. [13][16]

שלבי השדרוג

1. צרו גיבוי (Settings > System > Backups) ושמרו את ה-emergency kit, ואז קראו את ה-backward-incompatible changes של כל גרסה בין הגרסה שלכם לחדשה. [16][17]
2. הצמידו את ה-tag של הגרסה החדשה ב-compose.yaml (התיעוד משתמש ב-‎:stable; tag מוצמד מאפשר rollback), ואז הריצו docker compose pull ו-docker compose up -d. השאירו stop_grace_period: 60s כדי שהמסד ייסגר כראוי. [1][17]
3. אחרי העלייה, בדקו את Settings > System > Repairs ואת הלוגים להגדרות שצריך לשנות; שינוי schema של ה-recorder עלול לקחת זמן ודורש דיסק פנוי לפחות בגודל המסד. [14][17]

חזרה לאחור

הצמידו את ה-tag של הגרסה הקודמת, ‏docker compose pull ו-up -d. אם הגרסה החדשה שינתה את ההגדרות או את המסד, שחזרו את הגיבוי שנלקח לפני השדרוג. [16][17]

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

• בגרסה 2026.10.0: מצב ה-legacy של ספק האימות של Home Assistant הוסר: שמות משתמש תמיד באותיות קטנות ובלי רווחים בקצוות. תקנו לפני העדכון כל שם משתמש שסומן ב-repair. [20]
• בגרסה 2026.8.0: הגדרות שרת ה-web ‏(פורט, כתובות האזנה, Trust X-Forwarded-For, ‏trusted proxies) עברו ל-Settings > System > Network; בלוק http: קיים מיובא, ו-repair מבקש להסיר אותו. הפורט ב-Container נשאר 8123. [3][21]
• בגרסה 2026.8.0: ה-image החליף את jemalloc שנטען מראש ב-mimalloc המובנה של Python: ל-DISABLE_JEMALLOC כבר אין השפעה; להקצאה הרגילה הגדירו PYTHONMALLOC=pymalloc. [8][9]
• בגרסה 2026.3.0: ‏Home Assistant רץ על Python 3.14, וה-image של ה-container דחוס ב-zstd: נדרש Docker 23.0.0 ומעלה (containerd 1.5.0 ומעלה). [10][22]
• בגרסה 2025.12.0: התמיכה בשיטות ההתקנה Core ו-Supervised ובמערכות 32 ביט (i386, ‏armhf, ‏armv7) הוסרה; מערכות כאלה לא מקבלות עדכונים. ‏Container על שרת 64 ביט נשאר נתמך. [23]

מגבלות

• גילוי מכשירים, ‏Bluetooth ורכיבי USB עובדים רק בשרת שנמצא בבית: ב-VPS בענן Home Assistant לא רואה מכשירי mDNS/SSDP, ‏Bluetooth או מקלוני Zigbee/Z-Wave ברשת הביתית. הוא מיועד לשרת ביתי או ל-VM בבית. [1][2]
• ל-Home Assistant Container אין apps ‏(add-ons) ואין עדכון בלחיצה; ל-Thread ול-Z-Wave, שב-Home Assistant OS רצים כ-apps, אין תמיכה מובנית. הריצו את Z-Wave JS או Thread border router כ-containers נפרדים. [4]
• עם host networking ‏Home Assistant תופס את פורט 8123 ישירות בשרת: הריצו אותו כפרויקט Compose נפרד לצד stacks אחרים, השאירו את 8123 פנוי, והפנו את ה-reverse proxy לכתובת השרת ולא לרשת Docker. [1][3]
• נדרש Docker Engine 23.0.0 ומעלה; ‏Docker Desktop לא עובד. ה-recorder צריך כל הזמן דיסק פנוי לפחות בגודל המסד שלו (פי 2.5 כדי להתאושש משחיתות); היסטוריה ארוכה מ-10 ימים מגדילה אותו מהר. [1][14]

אבטחה

• המבקר הראשון ב-instance חדש יוצר את חשבון ה-owner, מנהל שאי אפשר לשחזר את פרטי ההתחברות שלו. סיימו את ה-onboarding ברשת המקומית לפני שחושפים את פורט 8123 או דומיין. [1][18]
• חשפו רק דרך HTTPS: מאחורי reverse proxy הפעילו Trust X-Forwarded-For והוסיפו את ה-proxy ל-Trusted proxies ‏(Settings > System > Network), אחרת הבקשות דרכו נחסמות; שקלו IP banning. התיעוד מעדיף VPN או tunnel על פני פתיחת פורטים. [3][19]
• ה-container הרשמי רץ כ-root עם privileged: true על רשת השרת, ולכן יש לו גישה רחבה לשרת. תנו לו שרת משלו בבית; אם צריך רק רכיב רדיו אחד, מפו את המכשיר הזה (devices: /dev/ttyUSB0) במקום privileged. [1][5]

גיבוי

• גיבויים אוטומטיים כבויים עד שמגדירים אותם (Settings > System > Backups): בחרו גיבוי יומי, כמה עותקים לשמור, ומיקום מחוץ לשרת. גיבויים מקומיים נשמרים ב-‎/config/backups, על אותו דיסק של הנתונים. [11][13][16]
• הגיבויים מוצפנים: שמרו את ה-emergency kit ‏(מפתח ההצפנה) במקום בטוח, בנפרד מהגיבויים. בלעדיו אי אפשר לשחזר גיבוי מוצפן. [16]
• גיבוי כולל כברירת מחדל את מסד ה-SQLite ומדלג על לוגים, על ה-cache של TTS ועל ארכיוני גיבוי קודמים. היסטוריה גדולה מגדילה כל גיבוי: הקטינו את purge_keep_days או החריגו ישויות כדי לשמור עליו קטן. [12][13][16]

גרסה אחרונה

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

Home Assistant 2026.10.1 [5][6]

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

Home Assistant 2026.10.1

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

נבדק ב-

14 באוק׳ 2026

מצב

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

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

GitHub Releases

נבדק ב-2026-10-14: ה-tag ‏stable מצביע על אותו image index כמו 2026.10.1 ב-GHCR, ו-2026.10.1 ‏(נדחף ב-2026-10-10) הוא ה-tag החדש ביותר שאינו beta ב-Docker Hub; ‏2026.11 עדיין בפיתוח.

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

גרסה

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

פורסם

נבדק מול גרסה

Home Assistant 2026.10.1

גרסת הפרופיל

1.0.0

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

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

עדיין לא זמין

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

האתר הרשמי

www.home-assistant.io

קוד מקור

github.com/home-assistant/core

חלופות

openHABDomoticz

מקורות

1. Home Assistant Docs: Linux, Install HA Container (Docker Engine 23.0.0+; compose: network_mode: host, privileged: true, /run/dbus:ro, stop_grace_period 60s; UI on 8123; --device mapping) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
2. home-assistant.io source: container/compose.md (/PATH_TO_YOUR_CONFIG:/config, /etc/localtime:ro, /run/dbus:ro, unless-stopped, privileged: true, network_mode: host, TZ) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. Home Assistant Docs: HTTP (Container port stays 8123; UI settings since 2026.8; behind a proxy set Trust X-Forwarded-For and Trusted proxies or requests are blocked; IP banning) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
4. Home Assistant Docs: Installation (Container has no apps and no one-click updates; Thread and Z-Wave are controlled by apps, no out-of-the-box support on Container; Raspberry Pi minimum 2 GB RAM) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
5. GHCR: home-assistant:2026.10.1 (= stable; linux/amd64 651,470,255 B compressed; no USER, no HEALTHCHECK, ENTRYPOINT /init (s6-overlay), WORKDIR /config, Apache-2.0) (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. Docker Hub: homeassistant/home-assistant tags (2026.10.1 pushed 2026-10-10, newest stable; amd64 651,470,255 B, arm64 636,862,738 B) (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. home-assistant/core Dockerfile at 2026.10.1 (s6-overlay rootfs, go2rtc 1.9.14 bundled, no USER, WORKDIR /config) (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. home-assistant/core rootfs/etc/services.d/home-assistant/run at 2026.10.1 (python3 -m homeassistant --config /config; PYTHONMALLOC=mimalloc by default, DISABLE_JEMALLOC has no effect) (מאגר רשמי · נקרא 14 באוק׳ 2026)
9. home-assistant/core rootfs/etc/services.d/home-assistant/run at 2026.7.0 (jemalloc preloaded unless DISABLE_JEMALLOC is set) (מאגר רשמי · נקרא 14 באוק׳ 2026)
10. home-assistant/core pyproject.toml at 2026.10.1 (version 2026.10.1, requires-python >=3.14.2) (מאגר רשמי · נקרא 14 באוק׳ 2026)
11. home-assistant/core components/backup/backup.py at 2026.10.1 (local backup agent writes to the config path 'backups', i.e. /config/backups) (מאגר רשמי · נקרא 14 באוק׳ 2026)
12. home-assistant/core components/backup/const.py at 2026.10.1 (backups skip logs, *.db-shm, backups/*.tar and tts/*; home-assistant_v2.db is excluded only when the database is left out) (מאגר רשמי · נקרא 14 באוק׳ 2026)
13. home-assistant/core components/backup/config.py at 2026.10.1 (automatic backups not configured and schedule 'never' by default; include_database true) (מאגר רשמי · נקרא 14 באוק׳ 2026)
14. Home Assistant Docs: Recorder (SQLite home-assistant_v2.db in /config; purge_keep_days 10; free space ≥ database size, 2.5× for corruption recovery; MariaDB ≥ 10.3, PostgreSQL ≥ 12) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
15. Home Assistant Docs: Long-term statistics (short-term every 5 minutes, purged with history; long-term every hour, never deleted automatically) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
16. Home Assistant Docs: Common tasks, Backups (automatic backups: daily recommended, e.g. keep 7; encrypted, emergency kit needed to restore; keep a copy off the system) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
17. Home Assistant Docs: Common tasks, Home Assistant Container (read every release note's backward-incompatible changes; docker compose pull and up -d; run a specific version by tag to downgrade) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
18. Home Assistant Docs: Onboarding (a new installation first creates the owner account, an administrator; owner credentials cannot be recovered) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
19. Home Assistant Docs: Securing (use a secure remote-access method, such as a VPN or the cloud tunnel, rather than exposing Home Assistant directly) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
20. Home Assistant 2026.10 release notes (legacy mode of the Home Assistant auth provider removed; usernames always normalized) (Release notes · נקרא 14 באוק׳ 2026)
21. Home Assistant 2026.8 release notes (web server settings, incl. port and trusted proxies, move from YAML to the UI; existing http: YAML imported) (Release notes · נקרא 14 באוק׳ 2026)
22. Home Assistant 2026.3 release notes (runs on Python 3.14; container images compressed with zstd, needs Docker 23.0.0+ or containerd 1.5.0+) (Release notes · נקרא 14 באוק׳ 2026)
23. Home Assistant 2025.12 release notes (Core and Supervised installation methods and 32-bit i386/armhf/armv7 support removed) (Release notes · נקרא 14 באוק׳ 2026)