• Installation via apt-get
• Manual installation (alternativly - including openHAB Designer)
• Yocto Layer

Note: for Hardware specific approach (e.g. ARM boards like Raspberry Pi) please visit the Hardware FAQ.

su -
echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | tee /etc/apt/sources.list.d/webupd8team-java.list
echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | tee -a /etc/apt/sources.list.d/webupd8team-java.list
apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys EEA14886
apt-get update
apt-get purge openjdk* (to remove previously installed lower versions)
apt-get install oracle-java8-installer
exit

$ sudo nano /etc/apt/sources.list.d/openhab.list

Add the following line in the editor: deb http://repository-openhab.forge.cloudbees.com/release/1.x.y/apt-repo/ /

Replace the x and the y by the appropriate version numbers. You can find the latest stable version at the OpenHAB downloads page.

Exit with CTRL X then Y

$ sudo apt-get update
$ sudo apt-get install openhab-runtime

The packages are not signed therefore you will get a warning!

Use "apt-cache search openhab" to get a list of all packages. Install the add-ons as you need them using "apt-get install".

$ sudo apt-cache search openhab
$ sudo apt-get install openhab-addon-binding-xy

In terms of configuration please visit the configuration page(s).

$ sudo /etc/init.d/openhab start

The server will run unprivileged using the account "openhab". The deb installer adds openHAB to the system startup.

openHAB comes with a built-in user interface. It works on all webkit-based browsers like Chrome, Safari, etc. Point your browser to http://localhost:8080/openhab.app?sitemap=yourname and you should be looking at your sitemap.

• openHAB engine (including /webapps folder) is installed in /usr/share/openhab.
• Configuration is located at /etc/openhab
• log-files are stored in /var/log/openhab

Changed configuration files will be retained even on upgrades!

$ sudo apt-get update
$ sudo apt-get upgrade

TBD

WARNING: this quick setup is an example for a KNX environment. You need different addons and configurations for other bindings.

The openHAB runtime comes as a platform-independent zip file. To install it, follow these simple steps:

1. You will need to install Java if not already installed. Go to http://java.com/ to get it. For ARM based systems and Synology Diskstation, see Hardware FAQ for instructions on getting Java.
2. Unzip the openhab-runtime-<version>.zip to where it is intended to be running from, e.g. /opt/openhab.
3. Copy the bindings you have downloaded -knx-binding-<version>.jar and http-binding-<version>.jar- to the "addons" directory.
4. Create a personal configuration file configurations/openhab.cfg and add the appropriate configuration parameters from configurations/openhab_default.cfg (depending on the bindings you've copied).

The openHAB designer comes as a platform-dependent zip, so choose the right type for your platform. To install it, follow these simple steps:

1. Unzip the openhab-designer-<platform>-<version>.zip to some directory, e.g. /opt/openhab-designer
2. Launch it by the executable openHAB-Designer
3. Select the "configurations" folder of your runtime installation in the folder dialog that is shown when selecting the "open folder" toolbar icon.

For please visit the configuration page(s).

1. Launch the runtime by executing the script start.sh

openHAB comes with a built-in user interface. It works on all webkit-based browsers like Chrome, Safari, etc. Point your browser to http://localhost:8080/openhab.app?sitemap=yourname and you should be looking at your sitemap.

For people who make their own linux distribution using Yocto, there is a openHAB layer available:

https://github.com/ulfwin/meta-openhab

You can also find it through the very convenient layer search site:

http://layers.openembedded.org/layerindex/branch/master/layers/

The layer contains one recipe that install both the runtime engine and addons. Check the README for specific instructions for the layer. How to add and use a layer is not covered here (you need to know that in order use Yocto in the first place), but some explanation can be found here:

http://www.yoctoproject.org/docs/1.6/dev-manual/dev-manual.html#understanding-and-creating-layers