First boot - HestiaPi/hestia-touch-openhab GitHub Wiki

Fix your HestiaPi's case to the wall first. If you simply want to test-drive HestiaPi before committing to it, connect the LCD first and then plug in a Micro USB cable to the Pi's port.

  1. Insert the MicroSD card back in the Raspberry Pi. Just push it in. It does not click. It does not lock in place. A tiny part of it will stick out just enough to grab and pull it if needed.
  2. Insert the LCD in the cover. Turn and push it in place. It should feel firm in place. Remove the protective film if present.
  3. Take all necessary precautions before applying mains voltage so cut off the power now!
  4. Connect Heating, Cooling, Fan and Hot Water (depending on model) control lines on the terminal block’s top contacts.
  5. Connect mains wires on the bottom contacts, marked L and N.
  6. Place the sensor at the bottom compartment of the cover and fit the 4 wires in the vertical slit. Note that the sensor, the little shiny square, should be placed facing outwards and ideally not be blocked by any plastic piece of the case.
  7. Push gently the cover against the 2 hooks of the base aligning at the same times the pins with the LCD connector. The cover should lock when pushed all the way in. Step back and enjoy the new looks of your wall :)
  8. If you cannot cut off the power on the cables, you are risking of HestiaPi booting before the LCD is connected. In such a scenario the LCD will not display anything but a blank white screen and you would need to restart as it is not "plug and play" like HDMI. We would advise to leave the SD card out before applying mains voltage and just before you are about to close the case, insert it but don't restart. It shouldn't boot. Once you close the case, there is a chance that it will restart. Close the case and wait 20 seconds. If nothing shows up on the screen, it didn't restart. Use something long like a screwdriver but non-conductive and press reset button. In some models it is located on the right of the LCD connector facing up. In other models it is on the right side.
  9. If at any time you want to remove the top case, there is one small round hole on each top and bottom edge of the case that push the internal hooks that keep the top case with the back plate secured. Use a pin or paperclip to push each side at a time but be gentle. Only a 2-3 mm push is needed to release them. This is a 3D printed case and not super flexible ABS.
  10. You should soon see the HestiaPi boot sequence and the loading screen at the end with a countdown. Follow these steps to connect your new HestiaPi to your WiFi.
  11. After a few seconds the screen will show if the WiFi is connected and what is the local IP it got (DHCP)
  12. The full installation may take up to 20 minutes for the very first time and a few restarts are normal. Just leave it alone. You can always SSH to it. Use pi/hestia
  13. The SD card image expands automatically to occupy the complete size of the card if available.
  14. While waiting, head over to the downloads section and download the smartphone app on your phone. Under settings set Local OpenHAB URL as http://[hestiapi_IP]:8080 and close the application
  15. Once the LCD is showing the UI, try and load the app again or simply use your laptop and navigate to: http://[hestiapi_IP]:8080/start/index and select “Basic UI”
  16. You should now be able to control the basic functions from either the App or your laptop
  17. Configure your local time (UTC by default) via SSH using the raspi-config command
  18. Please note that the UI of app, web and LCD change with some software updates so back up your customisations before running an update.
  19. OpenHAB2 has a great forum with so much information from fellow users. Salivate at what you want to make now with it.
  20. Feel free to explore the files under /etc/openhab2 names default.* in folders items, rules, sitemaps and things.
⚠️ **GitHub.com Fallback** ⚠️