openHAB 4 Distribution

Choose your system
Raspberry Pi
Linux
Windows
macOS
Docker
Choose your version
Stable
4.2.2
Milestone
4.3.0.M2
Snapshot
4.3.0-SNAPSHOT

Stable versions are thoroughly tested semi-annual official releases of openHAB. Use the stable version for your production environment if you don't need the latest enhancements and prefer a robust system.


Option 1: Use Raspberry Pi imager

  1. Select your openHABian image under Other specific-purpose OS - Home assistants and home automation.
  2. Insert the SD card in your device, connect the Ethernet cable and turn it on.
  3. If you want to use Wi-Fi, openHABian will launch a hotspot.
  4. Please read the docs while your box is installing openHABian.
  5. Navigate with a web browser to http://openhabian:8080
  6. Continue by following the tutorial to get started

Option 2: Install the APT Packages

TIP

On Debian systems you can also opt to add our openHABian turn-key solution on top of your existing operating system, follow these instructions instead to check whether your system is eligible and install it.

For Raspberry Pi, however, we strongly recommend flashing the complete OS image, see above.

  1. Install a recent Java 17 platform (we recommend the Zulu builds of OpenJDK)
  2. Add the repository key
  3. curl -fsSL "https://openhab.jfrog.io/artifactory/api/gpg/key/public" | gpg --dearmor > openhab.gpg
    sudo mkdir /usr/share/keyrings
    sudo mv openhab.gpg /usr/share/keyrings
    sudo chmod u=rw,g=r,o=r /usr/share/keyrings/openhab.gpg
  4. Add the HTTPS transport for APT
  5. sudo apt-get install apt-transport-https
  6. Add the repository
  7. echo 'deb [signed-by=/usr/share/keyrings/openhab.gpg] https://openhab.jfrog.io/artifactory/openhab-linuxpkg stable main' | sudo tee /etc/apt/sources.list.d/openhab.list
  8. Update the package lists and install the openHAB distribution package
  9. sudo apt-get update && sudo apt-get install openhab
  10. (Optional) Install the add-ons for offline use
  11. 🛈 You don't need the add-ons package if your machine has Internet access, openHAB will download add-ons online as necessary.
    sudo apt-get install openhab-addons
  12. Navigate with a web browser to http://<ip-address>:8080
  13. Continue by following the tutorial to get started

Option 3: Manual Installation

  1. Install a recent Java 17 platform (we recommend the Zulu builds of OpenJDK)
  2. Download and extract the openHAB runtime distribution:
  3. (Optional) Download the add-on archives for offline use and put them in the addons folder of the extracted distribution:
  4. 🛈 You don't need the add-ons archives if your machine has Internet access, openHAB will download add-ons you need online as necessary.
  5. Run ./start.sh and wait for openHAB to perform its initial startup (this can take a few minutes depending on your machine)
  6. Navigate with a web browser to http://<ip-address>:8080
  7. Continue by following the tutorial to get started

openHAB 3 Distribution

To download the previous version of openHAB, please go to https://v34.openhab.org/download/ (opens new window)

openHAB 2 Distribution

To download even older versions of openHAB, please go to https://v2.openhab.org/download/ (opens new window).

Applications

Acknowledgements