openHABian - Raspbian (minimal) unattended netinstaller for openHAB 2
Shell VimL Nginx
Latest commit 6614ced Jan 12, 2017 @ThomDietrich ThomDietrich Move raspi-config installation to independent function
Signed-off-by: Thomas Dietrich <>


Hassle-free openHAB 2 Raspbian image as a minimal unattended netinstaller for the Raspberry Pi.

This project is based on the powerful raspbian-ua-netinst and most technical details can be taken from there.

The provided image of only 64MB contains a minimal boot system. This system will then install Raspbian followed by openHAB and a set of useful tools. All packages will be downloaded in their newest version.

  • openHAB 2 latest snapshot (package repository)
  • Oracle Java 8 (build 1.8.0_101, needed for my.openhab)
  • Samba (preconfigured)
  • custom .bashrc and .vimrc files
  • openHAB syntax highlighting in vim and nano
  • uses whole SD card by default (8GB or 16GB SD card sufficient)
  • 16MB GPU memory split
  • git based versioning of etc by the help of etckeeper
  • useful packages like screen, mc, htop ...

The set of scripts may later also be used to configure any other kind of Linux system.

The next milestone is to provide an interactive configuration wizard, installing and configuring packages like HABmin, Homegear or Grafana.


  • Raspberry Pi models 1B+, 2B or 3B recommended
  • Write image to SD card (instructions)
  • Connect Ethernet, SD card and power to your Raspberry Pi
  • Wait up to 45 minutes (setup depends on your downlink as almost everything is downloaded live)
  • Green LED will indicate when setup is finished
    • Irregular blinking: setup in progress...
    • Steady "heartbeat": setup successful
    • Fast blinking: error while setup, check /var/log/raspbian-ua-netinst.log, create GitHub Issue
  • Connect to the openHAB 2 portal (available after another 15 minutes): http://openhabianpi:8080
  • Connect via ssh with pi:raspberry
  • Connect to the Samba network share with openhab:habopen
  • enjoy!

You may need to change the timezone setting through ssh and sudo raspi-config (Default is GMT+01:00). Besides that, you should be able to start working with openHAB 2 without further ssh contact.

Please note, that openHABian is a custom Raspbian image with certain preinstalled and preconfigured components. After initial setup use like a normal Linux system - refer to docs/RaspberryPi and docs/LinuxInstallation for further details.