Home Assistant מאחסן את התצורה שלו בקובץ בשם configuration.yaml. ברירת המחדל נוצרת כאשר ה – Home Assistant מופעל בפעם הראשונה. חלק מהדברים בקובץ התצורה ניתן לערוך באמצעות ממשק המשתמש, חלקים אחרים דורשים ממך לערוך את קובץ התצורה ישירות.
במדריך זה אפרט על שתי השיטות העקריות לעריכת קבצי הקונפיגורציה:
- שיתוף קבצים ועריכה באמצעות תוכנות כמו Notepad++.
- שימוש ב configurator ועריכה בדפדפן.
חלק א' – עריכה על ידי שיתוף קבצים – SMB
על מנת שנוכל לערוך את קבצי ההגדרה מרחוק יש "להחצין" את הקבצים ולחשוף אותם על ישי שימוש בשיתוף רשת (SMB). לצורך כך נתקין שרות שנקרא samba על גבי מערכת ההפעלה על ישי הפקודות הבאות:
1 2 | sudo apt-get update sudo apt-get install samba |
כעת, לאחר ההתקנה נערוך את קובץ הקונפיגורציה של השרות ונוסיף את התיקיות אותן נרצה לשתף. לצורך כך פתחו לעריכה את קובץ ההגדרות על ידי הפקודה הבאה:
1 | sudo nano /etc/samba/smb.conf |
מחקו את כל תוכנו והחליפו אותו בתוכן הבא:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | [global] netbios name = RP2 server string = The Pi File Center workgroup = WORKGROUP hosts allow = socket options = TCP_NODELAY IPTOS_LOWDELAY SO_RCVBUF=65536 SO_SNDBUF=65536 remote announce = remote browse sync = [HOME ASSISTANT] path = /home/homeassistant/.homeassistant comment = No comment browsable = yes read only = no valid users = writable = yes guest ok = yes public = yes create mask = 0777 directory mask = 0777 force user = root force create mode = 0777 force directory mode = 0777 hosts allow = |
כעת, לחצו כל ctrl+x על מנת לסגור את הקובץ ואז על y לשמירה.
בשלב הבא ניצור משתמש אשר ישמש אותנו להתחברות ברשת, לצורך כך הקישו בטרמינל את הפקודה הבאה:
1 | sudo smbpasswd -a pi |
כעת תתבקשו להקיש סיסמה עבור המשתמש וכן אימות סיסמה.
כעת נבצע אתחול לשרות ה SMB על מנת להכניס את השינויים לתוקף, לצורך כך הקישו את הפקודה הבאה:
1 | sudo service smbd restart |
תוכלו כעת לגשת לקבצי ההגדרה של המערכת על ידי לחיצה על התחל > הפעלה וכתיבת הפקודה
1 | \\[Pi IP Address] |
במידה והכל הוגדר כראאוי, אתם אמורים לראות מסך שנראה כך:
הקלידו את שם המשתמש והסיסמה שבחרתם ולחצו על OK, ותוכלו לראות את התיקיה של קבצי הקונפיגורציה:
כעת תוכלו לערוך את קבצי ההגדרות בכל עורך טקסט שתחפצו (ממולץ שימוש ב notepas++ או Visual Studio בעל תוסף לעריכה בשפת yaml).
*** טיפ עורך *** – כברירת מחדל בעת שיתוף קבצים התיקיה תהיה חשופה לעיני כל, כלומר כל מכשיר ברשת יוכל לגשת אליה (במידה והסיסמה שהוגדרה היא ברירת המחדל וידועה), על מנת להקשיח קלות את הגישה ניתן להשתמש בדבר שנקרא "שיתוף נסתר" או "שיתוף מנהלי" וזאת שינוי הערך של broswable מ yes ל- no.
במצב זה, מי שירצה להגיע לקבצים ידרש להקליד את הכתובת המלאה, קרי:
1 | \\[Pi IP Address]\Home Assistant |
חלק ב' – שימוש ב Configurator ודפדפן
configurator למי שאינו מכיר הוא שרות (service) אשר מותקן על גבי המערכת במקביל ל Home Assistant ומאפשר את עריכת קבצי התצורה של המערכת באמצעות דפדפן אינטרנט.
על מנת להתקין את השרות יש לפעול על פי השלבים הבאים (המדריך מתאים למשתמשים אשר משתמשים ב Hassbian Image וגם לאלה שהתקינו Virtual Env על פי המדריך הבא):
תחילה יש להתקין git על ידי הפקודה הבאה:
1 | sudo apt-get install git |
כעת הקישו את הפקודה הבאה בטרמינל:
1 | cd /home/homeassistant/.homeassistant |
כעת הקישו את הפקודה הבאה על מנת להוריד את קבצי השרות והתקנתם:
1 | sudo git clone https://github.com/danielperna84/hass-configurator.git |
כעת הקישו את הפקודה הבאה על מנת להכנס לתיקיה שזה עתה נוצרה:
1 | cd hass-configurator |
וערכו את קובץ ההגדות:
1 | sudo nano settings.conf |
וודאו שהוא נראה כך:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | { "LISTENIP": "0.0.0.0", "LISTENPORT": 3218, "BASEPATH": "/home/homeassistant/.homeassistant", "SSL_CERTIFICATE": null, "SSL_KEY": null, "HASS_API": "http://127.0.0.1:8123/api/", "HASS_API_PASSWORD": "iAmPassword!!!", "CREDENTIALS": null, "ALLOWED_NETWORKS": [], "BANNED_IPS": [], "BANLIMIT": 0, "IGNORE_PATTERN": [] } |
*** הערה *** – לרוב, לא צריך לשנות כלום. במידה והגדרתם סיסמה עבור ה Home Assistant יש להגדירה בקובץ בשורה: "HASS_API_PASSWORD": "iAmPassword!!!".
כעת הקישו ctrl+x ו-y לשמירה ולחצו על אנטר לאישור.
בשלב הבא נגדיר ל Configurator לעלות עם מערכת ההפעלה (על מנת למנוע את הצורך בהפעלה ידנית בכל פעם מחדש), לצורך כך כתבו את הפקודה הבאה:
1 | sudo nano /lib/systemd/system/configurator.service |
והעתיקו פנימה את הטקסט הבא:
1 2 3 4 5 6 7 8 9 10 11 12 | [Unit] Description=Hassio configurator After=network.target [Service] Type=simple User=homeassistant ExecStart=/usr/bin/python3 /home/homeassistant/.homeassistant/hass-configurator/configurator.py /home/homeassistant/.homeassistant/hass-configurator/configurator.conf Restart=on-abort [Install] WantedBy=multi-user.target |
סגרו את העורך באמצעות לחיצה על ctrl+x ואז y ואנטר לאישור.
כעת ניתן לקבוץ שיצרנו הרשאות ריצה על ידי הפקודה הבאה:
1 | sudo chmod 644 /lib/systemd/system/configurator.service |
כעת נפעיל את השרות על ידי הפקודות הבאות:
1 2 3 | sudo systemctl daemon-reload sudo systemctl enable configurator.service sudo systemctl start configurator.service |
כעת פתחו את הדפדפן והקישו את כתובת השרת בתוספת פורט 3218, לדוגמה: http://192.168.0.1/3218. במידה והכל הוגדר כראוי אתם אמורים לקבל מסך שנראה כך:
כמובן שאם hassio הכול הרבה יותר קל
מחד נכון, מאידך המערכת הזו כל כך סגורה שמאוד קשה להוסיף לה יכולות. בניגוד ל Hassbian או התקנה ידנית באמצעות Virtual Env. אגב, הם נוטשים את hassio ועוברים ל hassos.