openHAB 3 Distribution

Choose your system
Raspberry Pi
Linux
Windows
macOS
Docker
Choose your version
Stable
3.3.0
Milestone
3.4.0.RC1
Snapshot
3.4.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: Flash the openHABian image to a SD card (Recommended)

  1. Download and install Etcher
  2. Download the openHABian image (.img.xz file) for your system from https://github.com/openhab/openhabian/releases/latest:
  3. Write the image to your SD card using Etcher
  4. Insert the SD card in your device, make sure you have connectivity, either by plugging an Ethernet cable or configuring the Wi-Fi, and boot!
  5. Wait between 15 and 45 minutes for openHABian to perform its initial setup
  6. If you chose to use Wi-Fi, and there's a problem, openHABian will launch a hotspot. Connect to it if necessary
  7. Navigate with a web browser to http://openhabian:8080
  8. 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 11 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 11 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 2 Distribution

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

Applications

Acknowledgements