Download openHAB
openHAB 4 Distribution
Choose your system
Raspberry Pi
Linux
Windows
macOS
Docker
Choose your version
Stable
4.2.2
4.2.2
Milestone
4.3.0.M2
4.3.0.M2
Snapshot
4.3.0-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
- Select your openHABian image under
Other specific-purpose OS - Home assistants and home automation
. - Insert the SD card in your device, connect the Ethernet cable and turn it on.
- If you want to use Wi-Fi, openHABian will launch a hotspot.
- Please read the docs while your box is installing openHABian.
- Navigate with a web browser to
http://openhabian:8080
- 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.
- Install a recent Java 17 platform (we recommend the Zulu builds of OpenJDK)
- Add the repository key
- Add the HTTPS transport for APT
- Add the repository
- Update the package lists and install the openHAB distribution package
- (Optional) Install the add-ons for offline use 🛈 You don't need the add-ons package if your machine has Internet access, openHAB will download add-ons online as necessary.
- Navigate with a web browser to
http://<ip-address>:8080
- Continue by following the tutorial to get started
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
sudo apt-get install apt-transport-https
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
sudo apt-get update && sudo apt-get install openhab
sudo apt-get install openhab-addons
Option 3: Manual Installation
- Install a recent Java 17 platform (we recommend the Zulu builds of OpenJDK)
- Download and extract the openHAB runtime distribution:
- (Optional) Download the add-on archives for offline use and put them in the
addons
folder of the extracted distribution:
🛈 You don't need the add-ons archives if your machine has Internet access, openHAB will download add-ons you need online as necessary. - Run
./start.sh
and wait for openHAB to perform its initial startup (this can take a few minutes depending on your machine) - Navigate with a web browser to
http://<ip-address>:8080
- 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
- JFrog is providing an Artifactory instance for our builds
- DigitalOcean sponsors our community forum hosting.
- EJ Technologies is providing us open source licenses for JProfiler to make openHAB even more awesome.
- Netlify provides continuous deployment and hosting for this website.