openHAB 2 Distribution

PLEASE READ THE DOCS

Only a quick reference and download links are provided below, all platforms and steps after the installation are not covered.

If you're new to openHAB, it is strongly recommended to read the Installation Guide for a complete overview of your options and detailed instructions.

Choose your system
Linux
Windows
macOS
Raspberry Pi
PINE A64
Docker
Choose your package manager
...
APT (.deb packages)
...
RPM (.rpm packages)
Choose your version
Stable
2.3.0
Milestone
2.4.0.M8
Snapshot
2.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.


Package Installation (Recommended)

  1. Add the repository key
  2. wget -qO - 'https://bintray.com/user/downloadSubjectPublicKey?username=openhab' | sudo apt-key add -
  3. Add the HTTPS transport for APT
  4. sudo apt-get install apt-transport-https
  5. Add the repository
  6. echo 'deb https://dl.bintray.com/openhab/apt-repo2 stable main' | sudo tee /etc/apt/sources.list.d/openhab2.list
  7. Update the package lists and install the openHAB distribution package
  8. sudo apt-get update && sudo apt-get install openhab2
  9. (Optional) Install the add-ons for offline use
  10. 🛈 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 openhab2-addons
  11. Navigate with a web browser to http://<ip-address>:8080
  12. Continue by following the First-time setup chapter of the New User Tutorial

Manual Installation

  1. Install a recent Java 8 platform (we recommend Zulu), see prerequisites
  2. Download and extract the openHAB runtime distribution from https://bintray.com/openhab/mvn/openhab-distro:
  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 First-time setup chapter of the New User Tutorial

Applications

Acknowledgements