How to Install openHABian on Raspberry Pi (Step-by-Step Guide)

If you’re looking for a simple way to turn your Raspberry Pi into a powerful home automation hub, openHABian is an excellent choice. It’s an optimized Raspberry Pi setup for openHAB that handles most of the tricky configuration steps for you. I recently tested it, and I’ll walk you through the process in this guide.

openHABian can be installed on a Raspberry Pi by either flashing the dedicated image to an SD card or installing openHAB using the package manager on Raspberry Pi OS.

In this tutorial, I’ll explain both installation methods step-by-step, show you how to complete the initial boot, and provide a few tips to help you start controlling your smart devices with openHAB. Let’s dive in!

If you’re new to Raspberry Pi or Linux, I’ve got something that can help you right away!
Download my free Linux commands cheat sheet – it’s a quick reference guide with all the essential commands you’ll need to get things done on your Raspberry Pi. Click here to get it for free!

What Is openHABian (And Why Use It on Raspberry Pi?)

openHAB stands for open-source Home Automation Bus. It is a free and open-source home automation platform designed to be vendor-independent, and is a good alternative to tools like Home Assistant or Domoticz.

openHABian, on the other hand, is a preconfigured OS tailor-made for Raspberry Pi that has the openHAB preinstalled and ready to use.

When compared with Home Assistant, openHAB is Java-based and therefore is very flexible and stable. Furthermore, it offers strong support for standardized protocols, including Z-Wave, Zigbee, KNX, and MQTT.

Here’s a quick comparison between openHAB, Home Assistant, and Domoticz:

Feature	openHAB	Home Assistant	Domoticz
Ease of Setup	Medium – openHABian simplifies installation but setup still needs some manual steps	Easy – guided setup wizard and auto-discovery of devices.	Easy – lightweight install, fewer steps.
User Interface	Functional but less polished.	Modern, intuitive, very user-friendly.	Simple, dated look.
Integrations	Wide range (Z-Wave, Zigbee, KNX, MQTT, etc.).	Largest ecosystem, thousands of integrations.	Limited compared to HA/ openHAB.
Performance on Pi	Stable, good performance on Pi 3/4/5.	Heavier, best on Pi 4/5 (Pi 3 can feel slow).	Very lightweight, works well even on older Pi models.
Community & Support	Medium-sized, steady community.	Very large, active, fastest updates.	Smaller, slower development pace.
Customization	High – powerful rules engine (DSL, scripts, UI-based rules).	Very high – automations, add-ons, Node-RED, ESPHome.	Moderate – basic scripts and scenes.
Updates	Stable, slower release cycle.	Frequent updates, sometimes breaking changes.	Infrequent, slower development.
Best For	Stability and long-term reliability.	Beginners and advanced users who want the most features.	Lightweight setups and older hardware.
Relevant Tutorials		Getting Started with Home Assistant on Raspberry Pi	How to Install Domoticz on Raspberry Pi

What You’ll Need Before Installing

But before we get started with installing openHABian on our Raspberry PI, there are a few things that we need to get ready:

• Raspberry Pi: In this post, I have used a Raspberry Pi 400. openHAB is relatively lightweight and can run efficiently on the Pi 3 as well. However, if you plan to purchase a new Raspberry Pi, I recommend going for a Pi 5 or Pi 4 at the very least.
• Blank SD Card: While openHABian can be installed on a smaller SD card (8GB), I recommend using at least a 32GB high-endurance SD Card.
• SD Card Reader: You can use any SD Card Reader you have. You can consult this article for more information on how to read a Raspberry Pi SD Card on Windows.
• Raspberry Pi Imager installed on a PC: You can also use Balena Etcher or DD; however, openHABian is natively available through the Raspberry Pi Imager. If you are using any other method, you will need to download the image file manually from their GitHub repository.

Two Ways to Install openHABian (Pick the Right One)

As previously mentioned, there are two methods to install openHAB on your Raspberry Pi:

• You can download the standalone openHABian image file and flash it on an SD card.
• Alternatively, you can also install Raspberry Pi OS on a blank SD card and then install openHAB using the package manager.

By default, I recommend the first method for most users. However, if you already have your Raspberry Pi set up or if you want to install some program or script in parallel with openHAB, then you can opt to install openHAB manually.

Method 1: The Easy Way – Use the openHABian Image

The easiest method to install openHAB is through the openHABian Image through the Raspberry Pi Imager.

Download and Flash the openHABian Image

The openHABian image is available through the Raspberry Pi Imager. To install, connect your SD Card to your PC using an SD Card Reader and launch the Raspberry Pi Imager.

Choose the correct device (whichever Raspberry Pi you have), and click on “Choose OS”:

Navigate to Other specific-purpose OS -> Home assistants and home automation -> openHAB -> openHABian (64 bit).

You can follow the rest of the setup as you do when installing an OS using Raspberry Pi Imager.

Configure WiFi Before First Boot (Optional)

Before booting from the SD Card that you have flashed, we can edit some configuration to make the rest of the process easier. You can find the initial configuration file (openhabian.conf) in the /boot/ directory (on the bootfs partition if you are working on a Windows PC).

You can edit it using any text editor.

There are several settings that you can modify through this file; for more information on all the configuration options, refer to their official documentation. However, I recommend that you at least configure the WiFi settings and the hostname for easy access in a headless environment.

Boot Your Pi and Run the First Setup

Once you are ready, you can insert the SD Card into your Raspberry Pi and let it boot. It will restart a few times to complete the initial configuration. If you are running in headless mode, you can verify that your system has successfully connected to the internet by using the ping command.

If, for some reason, you cannot ping it or if you did not configure WiFi settings in the previous section, openHABian will automatically generate a hotspot that you can connect to:

Once connected to this hotspot, you will be automatically directed to a webpage where you can configure and set up the WiFi connection you want to establish.

Once the WiFi is connected and your Raspberry Pi has access to the internet, it will automatically download and install the required packages to set up your system (this can take several minutes depending on the speed of your network connection).

You can also SSH into your Raspberry Pi to monitor the progress of the initial setup.

Once the initial setup is complete, you can access the openHAB dashboard by opening this link in a web browser:
http://<Hostname>:8080

Method 2: Advanced – Install on Raspberry Pi OS

Suppose you already have your Raspberry Pi OS set up and want to install openHAB alongside other applications or scripts that are already running on it. In that case, you can download and install openHAB using its setup script.

Suppose you haven’t installed Raspberry Pi OS yet and plan to install openHAB manually alongside other programs or customize your system. In that case, I recommend using the Raspberry Pi Imager to install Raspberry Pi OS Lite.

Update Raspberry Pi OS and Get Ready

There are a few things we need to get ready before installing openHAB. First, make sure your system is up to date using the command:
sudo apt update && sudo apt full-upgrade -y

Now, check if Java is installed on your system. openHAB 5.x requires Java 21 (64-bit). You can check if you have it installed or not using the command:
java -version

If you don’t see any version (like shown above) or see a version number lower than 21, then we need to install Java 21. To do so, you can follow these steps:

• Install the pre-requisite helper tools:
  sudo apt install -y wget apt-transport-https gpg
  
• Download the repository signing key using the command:
  wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg >/dev/null
• Add the repository to your system repositories using the command:
  echo "deb https://packages.adoptium.net/artifactory/deb $(. /etc/os-release; echo $VERSION_CODENAME) main" | sudo tee /etc/apt/sources.list.d/adoptium.list >/dev/null
• Now update your package list:
  sudo apt update
  
• Finally, we can install Java 21 using the command:
  sudo apt install -y temurin-21-jdk
  
• Now, if you check, you will see that the correct version of Java has been installed.
  

That is it; now we are ready to proceed with the installation of openHAB on our Raspberry Pi.

Tip: Command lines can be a pain to memorize. I put the essential Linux commands on a printable cheat sheet so you don't have to keep googling them. You can grab the PDF here if you want to save some time.

Install openHAB Using the Package Manager

There are two ways to install openHAB on your Raspberry Pi manually. If you want a specific version of openHAB, you can download its setup script from GitHub and then install it using that. You can read more about this method on their documentation.

There is an alternative method that we will use in this tutorial, namely, adding the openHAB repository to your package manager and installing it using APT. This method has the added advantage of automatic updates along with other system updates.

To install openHAB, follow these steps:

• First, we need to download the GPG signing key used to verify openHAB packages:
  curl -fsSL "https://openhab.jfrog.io/artifactory/api/gpg/key/public" | gpg --dearmor > openhab.gpg
• Ensure that the keyring directory exists; if it doesn’t, create a new one:
  sudo mkdir -p /usr/share/keyrings
• Now move the openHAB key file into the system keyrings directory so that APT can use it to verify packages:
  sudo mv openhab.gpg /usr/share/keyrings/
• Next, we need to set the correct file permissions:
  sudo chmod 644 /usr/share/keyrings/openhab.gpg
• Then, we can add the openHAB repository to our system repositories:
  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 >/dev/null
• Before proceeding with the installation, we need to refresh the package list:
  sudo apt update
  
• Finally, we can install openHAB using the command:
  sudo apt install -y openhab
  

Once installed, we can run openHAB using the systemctl command:
sudo systemctl start openhab.service

In addition, you can permanently autostart openHAB so that it runs automatically on every boot:
sudo systemctl enable openhab.service

Now you can visit the link below to access the openHAB dashboard:
http://<Hostname or IP of Raspberry PI>:8080

Note: On the first start, it may take several minutes while caches are being built. The dashboard becomes available once processing is complete. There’s no visual indicator, so the best you can do is keep refreshing the page until the dashboard becomes visible.

First Steps Inside openHAB

With openHAB installed on our Raspberry Pi, the system is now ready for use. We can now configure our system and set up devices.

Complete the Initial Setup Wizard

We can access the openHAB Dashboard by opening this link in any web browser:
http://<Hostname>:8080

On first boot, we need to create an administrator account.

Next, input the Language and Region settings and click on “Begin Setup”:

The setup wizard will guide you through various options to configure the system according to your preferences.

Once the initial setup is complete, you will be greeted with the welcome screen.

You can click on “Get Started,” and you will be taken to your dashboard.

Add Your First Devices and Items

The openHAB dashboard defaults to the “Overview” page. Before we can begin configuring the pages, we need to add devices to our openHAB.

openHAB has its own nomenclature, like Bindings, Things, Channels, Items, Rules, and Pages. You can read more about this and get acquainted with the openHAB ecosystem through their documentation.

Install the Relevant Binding

Before adding any device to openHAB, you need to install the relevant add-ons for the specific bindings. There are various bindings available, and you should choose the appropriate one based on the device you intend to add. To install a binding, follow these steps:

• Click on the “Settings” menu from the left panel:
  
• Click on “Things”:
  
• Now click on the little “+” button to add a new thing.
• Click on “Install More Bindings”:
  
• Search for your desired binding and click on “INSTALL” (we are downloading the Systeminfo binding, which enables us to read the system information of our Raspberry Pi).
  

Add the Thing

Once the binding is installed, we need to add the thing to our openHAB. Things are an openHAB-generated representation of devices. To create a new thing, follow these steps:

• Navigate to Settings -> Things -> +.
• Click on the newly installed binding.
  
• Click “Scan”, and your device will appear under the “Discovered Things” section.
  
• Click on your device and select “Add as Thing” from the pop-up menu.
  
• Give it a label/ name and press “OK”.
  

That is it, the device will now be visible in your “Things” menu and will show that it is online.

Access a Channel Through an Item

Now, before we can read any data from this sensor/device, we need to access one of its channels and associate it with an item. To do so, follow these steps:

• Click on your device in the “Things” menu.
• Navigate to “Channels” from the top menu.
  
• This will display the list of all available information feeds that this sensor supports.
• You can search for and select the channel you want to associate with an item (for example, searching for “CPU Load”) and click “Add Link to item …”:
  
• Choose “Create a new item” and click on “Link”.
• Now, navigate to Settings -> Items and verify that the channel has been connected to the item, displaying the actual value reported by that channel.
  

Add the Item to a Page

Now that we have configured the device to report a specific value from its sensor, we can link this value to a widget on a page and visualize the data.

For example, to add a gauge to your overview page, follow these steps:

• Navigate to Settings -> Pages -> Overview Layout.
  
• Click Add Block -> Add Row -> Add Column, and then click the black box to add a widget.
  
• Select the desired widget and connect it to the item that we created earlier.
• Finally, when you are done, click “Save” in the top-right corner.

Now, when we return to our dashboard overview screen, we will see that the widget (gauge) has been added to our home screen, displaying the data from our sensor/device in real-time.

By repeating these steps, we can configure other devices as well and customize the dashboard to fit our requirements.

With openHABian, turning your Raspberry Pi into a powerful smart home hub is easier than ever. Whether you choose the dedicated image for a quick setup or the manual method for more flexibility, you’ll have a stable and customizable system ready to control your devices. Once installed, it’s just a matter of adding bindings and creating items to start building your own smart home.

Not getting the same result?

Even when you follow every step, small differences in OS version, hardware or config can change the outcome. Instead of wasting time guessing, get help from people who have already fixed the same kind of issue.

Ask your question now →

🔒 No risk. Cancel anytime.

• Get help on your exact issue
• Access step-by-step videos for tricky setups
• Browse the website without ads