openHABian hassle-free openHAB Setup


The Raspberry Pi and other small single-board computers are quite famous platforms for openHAB. However, setting up a fully working Linux system with all recommended packages and openHAB recommendations is a boring task taking quite some time and Linux newcomers shouldn’t worry about these technical details.

A home automation enthusiast doesn’t have to be a Linux enthusiast!

openHABian aims to provide a self-configuring system specific to the needs of every openHAB user.
Ready to install images are available for the Raspberry Pi and the Pine A64. openHABian can also be used on existing Debian based Linux systems. Follow the links below to learn more:

Enjoy! :tada:


In this thread I’m going to announce updates to openHABian.

Please check these and other postings in between to stay up to date. You might want to set the notification setting of this thread to “Tracking”.

Stay tuned!


Feel free to ask any openHABian related question in the comments below. Please remember, that openHABian is a customized Raspbian (Debian) Linux and installs openHAB unmodified…

  • Please do not ask generic Linux questions you might find a quicker answer for on Google.
  • Please do not ask generic openHAB questions, check the forum for existing threads otherwise create a new one.

If a posting in a new thread is or might be related to openHABian, add the openhabian tag to your posting.

Besides all the above, if you are unsure, do not hesitate to leave a comment in this thread.

OpenHAB2 - Addon install through paper UI - Habmin - Other primer questions
Recommended openHAB Version
Raspi 2: Move system root to usb-SSD
Migration from OH 1.x to OH 2 Tutorial
Auto-starting openHAB 2 with Ubuntu
Some Beginner questions
Unable to start openHAB service on raspberry pi - failed
OpenHAB 2 beginners / n00b guide?
Error when installing openhab2 on raspi b3
Openhab install
Openhab2 - auto discovered things - Sitemaps / Item files
[openHABian] Vanilla installation does not work
Can not start OH2?
[Solved] How to define a serial port on raspberry for openhab2 for my razberry zwave binding?
OH2 "fresh" install failing
Share openhab folders on RPI
Need a good guide link
How to install the openhab paperUI
Recommended openHAB Version
Help Im new to openhab
OH2 database or files
OpenHAB powerboard
A single distro from now on!
Exec Binding script for 1wire temps on OpenHABianPi GPIO
OpenHAB2 on separate USB (Raspberry Pi)
Addons.cfg: Proper way to discover the name of an addon
Openhab2, InfluxDB no longer working
MIgration to OpenHab2
CUL (Intertechno) binding FS20 binding
So long and thanks for all the fish
Zigbee binding
Pi3/habmin/razberry: no nodes (solved)
openHABian 1.7.x release announcements
Raspberry Pi 4 released
Openhabianpi or install on Raspbian
openHABian v1.4 / v1.4.1 released!
WIFI does not work at Raspberry Pi 3
Pi3/habmin/razberry: no nodes (solved)
Pi3/habmin/razberry: no nodes (solved)
Does openHABian offer more than a Command Line?
[SOLVED] Pi + Samba, access from mac
openHABian v1.4 / v1.4.1 released!
openhabian,Z Stick offline, serialport issue
New openhabian on raspberry pi, zwave OFFLINE - COMMUNICATION_ERROR zwave.thingstate.serial_notfound
Problems with Smart Home Designer
New to openhab, wanting to learn voice control
Razberry Board doesn't appears as node in HabMin
Raspian + OH2 on Raspi
Can't manage to update to openhab 2.1 snapshot from openhabian
Openhabian: Add single snapshot jars to release version?
Openhabian: Add single snapshot jars to release version?
Error in installation on Raspberry Pi
RaZberry2 OpenHAB2 Bridge_Offline
OH + RPi2 - Move everything away from SD Card
OpenHab Cloud Will Not Connect
Nrjavaserial upgrade causes "Serial Error: Port /dev/ttyACM0 does not exist"
Zoneminder binding
[SOLVED] USB Insteon PLM port not connecting
Insteon device response delay with rules
A General Question about OpenHAB
openHAB2 conflicts on homegear image (Pi3, Jessie)
Undertaking a volunteer effort using OpenHab and have CalDAV, Ecobee, and OH2 questions
OH2 + Orange Pi (armbian)
Migration OH1 -> OH2, especially z-wave related
Which HW ? Pi 2, Synology DS?
SSH session timing out on slow hardware

And I just spent a week setting up a Pi, OpenHab2 (failing), erasing it all, setting up OpenHab1, Habmin, and finally getting both the MiOS (Vera3), and Z-Wave (Aeon Labs ZStick Gen 5) bundles working.

I hope this works out well, I’m not willing to take the plunge and mess up the umpteen hours of research and pulling my hair out, but for those like me that this is their first foray into linux this could be fantastic!


When I get some spare time I will definitely try this on the newly purchased raspberry pi 3

reports like this were the reason for building the image :wink: A home automation enthusiast shouldn’t need to be a Linux enthusiast!
If you still want to give it a try, you can just use a second sd card.

Would be great to hear that it works. I made sure that it should but I only tested on my “Raspberry Pi Model B Plus Rev 1.2” and “Raspberry Pi 2 Model B Rev 1.1”

New features as of yesterday:

  • raspi-config now preinstalled
  • 16MB memory split out of the box
  • etckeeper installed and configured
  • a nice motd is ready but I’m waiting for one bug to be fixed.

Soon to come: Additional interactive options, first will be homegear and zsh. Please let me know which tools you would like to see preinstalled or as optional components! The goal should be to have a stable preconfigured openHAB 2 Raspbian installation packed with options but still transparent and open for user-specific needs.

The currently available release is still up-to-date as the setup script is downloaded live as well now.

1 Like


that comes handy, cause my sdcard crashed while we were on vacation :frowning:
Of course I have no complete backup image :slight_smile:

Will try openHABian for setting up a new installation.

Regarding usefull packages and because you mentioned “screen”:
I would vote for “tmux” instead or in addition to screen. Works like a charm, has additional cool features and is ways easier to configure.

I have fixed a few more details yesterday. Optional components are not part of the image yet but everything else is at a point where it can be used by everybody. I have uploaded an image including the latest changes.
I will be on a short vacation for the rest of the week and will start working on optional components (Homegear, Grafana, Logstash) after that. Let me know what else you would like to see :wink:

@peter_juenger do you know byobu? There are so many different tools and screen is, I would say, the most common. It would not hurt to have one more package, on the other side I’m trying to provide a useful but not bloated image. There is already vim vs nano and mc vs vfu and till now I refrained from installing my beloved ZSH to not confuse users (but I’ll soon, everyone should use ZSH ;P).
Out of personal interest, why would you prefer tmux? I never tried it and “s-c-r-e-e-n” is already saved in my muscle memory :wink:

@ThomDietrich: Installation is running, waiting for it to finish …

OT about screen: Never heared about byobu. I gave screen two or three tries over the last ten years. Always ended up in a mess. From my point of view it was ugly to configure and to use (shortcuts not easy to remember and not logical, old cruft …)

I then gave up to use a terminal multiplexer for a long time. Last year I had the strong need for such thing again and I googled for an alternative to screen, which is actived developed and easy to set up, to configure and to use.
I ended up with tmux and didn’t regret it so far.

I’m autostarting some sessions at logon and I like the easy possibility to split the screen horizontaly or vertically.

I’m sure that everything also is possible with screen, but I’m convinced that it’s much more difficult than with tmux (at least for me)

I’ll look into it, for openHABian or for myself :wink:
Let me know if everything went fine - you should see the “heartbeat” LED and a success log under /var/log/raspbian....log

Everything up and running again, thank you very much!

Installation finished at Tue Aug 23 09:51:49 UTC 2016 and took 26 min 59 sec (1619 seconds)

Installation was done on a rpi2 with 100 Mbps Downlink.

After booting I just copied my old /opt/openhab2/conf folder to /etc/openhab2, set timezone and that was it (more or less).

openhabian was a real time saver for me.

Because openhabian is based on raspbian, installing tmux was as easy as “sudo apt-get install tmux”

So thanks again, and looking out for the new fancy toys (Grafana, …) some time soon.

1 Like

Wow, nice! At my home it’s 45 minutes to load everything. Happy to hear it worked out fine :wink:

Did you have to set the timezone? I have the feeling the default should have been right for you. Grafana will be there soon, it’s such a great addition :wink:

Hi, I have installed openHABian, thank you very much. I however experiencing some problems and cannot activate OpenHAB. These are my issues:

  1. I coppied over the full config directory
  2. Could not copy over userdata directory, as I am not sure where it goes in this new structure.
  3. Cannot enter su as the ‘raspberry’ password does not work, please advise su password?
  4. Java 1.8.0 101 required for, but upgrade keeps failing
  5. Accessing the gui not responding - do I first need to install the autostart script?


Some things to point.
Installed as instructed with no previous configuration to copy. Accessing the http//::8080 return error (page not found). Then i did an update/upgrade (sudo apt-get update && sudo apt-get upgrade) and the openhab2-offline package was updated.

Tried again accessing the http//::8080 and voila the page for selecting the UI.

Hi I have tried this but it hasn’t worked and wondered if anyone knew why? I have down loaded the file and extracted all of the files and put them on the sd card and have plugged the ethernet and the power in but I only get a solid Green and red light and there lights on the ethernet on my pi and router are not lit either. Thanks

One thing to note is that the /etc/openhab2/ which is supposed to hold the configuration is not updated at all although changes are made through the UI (paper UI). I have added 3 bindings but no file in this directory.

1 Like

Hey guys,
please be aware that openHABian is “only” a preinstalled and preconfigured Raspbian with settings similar to what was documented here and here (by me). That’s why a few of your problems are not really related to openHABian.

This is indeed a small mistake I made. Other than with the platform independent zip file, the package repository installation divides your files up into different folders - as documented under file locations.
The folder you are looking for is /var/lib/openhab2. You can copy your files over by the help of the ssh console or you can create an additional share via samba. I have done that to openHABian just now. Thanks for pointing out this detail :wink:
In your installation, just copy these lines into /etc/samba/smb.conf

This is how it should be. The root account is disabled by default on many Linux distributions nowadays. This is done in favor of the less risky possibility to use sudo. When you type su, you are asking your system to switch to the root account which is answered by a prompt for the root password. The root password is not “raspberry”, there is no root password, that’s why su fails with an authentication error :wink: You should use sudo on a per-command basis or if you really know what you are doing and you want a root console, use sudo su.

I’ll look into that!

The instructions were not joking: “Connect to the openHAB 2 portal (available after another 15 minutes)”. The first start takes some time but the portal will pop up eventually, believe me. This is not related to openHABian.

Same as above: “page not found” can be seen after around 10 minutes. Just have a little patience and give it 5 more minutes :wink:

Something went totally wrong here :open_mouth: Please go to openhabian/releases and download the newest openhabian-ua-netinst-....img. This file needs to be flashed to your SD card as with every other RaspberryPi image. Good luck!

This is a key functionality of openHAB 2 and PaperUI. PaperUI uses a database (in the userdata folder) to store settings. The etc folder allows to manually configure a system through files. Settings between these two worlds are NOT synced! There are multiple threads on this topic here in the forum.

@Stephen_F Thanks for pointing that out. I have updated the install script but it’s not working just now. I’ll have to look into that at the beginning of next week.
Till then, please execute the following commands to switch over:

sudo su

systemctl stop openhab2.service
apt purge oracle-java8-jdk

cat <<EOT >> /etc/apt/sources.list.d/webupd8team-java.list
deb trusty main
deb-src trusty main

apt-key adv --keyserver hkp:// --recv-keys EEA14886

apt update
apt -y install oracle-java8-installer
apt -y install oracle-java8-set-default

systemctl start openhab2.service
1 Like

I have done some further small changes. Installing java via the webupd8team repository is sadly accompanied by some problems (the installation chroot environment is a bit restricted). I have reverted the changes for now.
You only need the newer java revision if you want to use the my.openhab service. In this case, please just execute the above commands.
Everyone else is perfectly fine with the raspbian provided revision installed currently!

Thanks, I have tried again and it looks to be working now, just need to check it later when it has finished