Skip to content

IDE Setup

John Cocula edited this page Jun 1, 2016 · 27 revisions
This page is out of date. Please check here for the latest info.

How to set up a development environment for openHAB


If you are a developer and not a pure user yourself, you might want to setup your Eclipse IDE, so that you can debug and develop openHAB bundles yourself. There are (at least) two options for getting the IDE running: pure eclipse and vagrant.

'Pure Eclipse' Instructions

  1. Create a local clone of the openHAB repository by running "git clone" in a suitable folder.
  2. Download and install oracle jdk 1.7
  3. Download and install the Eclipse for RCP and RAP Developers.
  4. Create a new workspace.
  5. Choose FileImportGeneralExisting Projects into Workspace, enter your clone repository directory as the root directory and press "Finish".
  6. After the import is done, you have to select the target platform by selecting WindowPreferencesPlug-in DevelopmentTarget PlatformopenHAB from the main menu. Ignore compilation problems at this step. On this step Eclipse needs some minutes to load all the files for the target platform. I'ts very important to wait with the next step until Eclipse is finished with this step.
  7. Download and install Maven 3. Set MAVEN_OPTS to -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m in order to avoid memory problems during the build process.
  8. Execute mvn clean install from the repository root. You will find the (binary) results in the folder distribution/target. On the very first code generation, you are asked on the console to download an ANTLR file, answer with "y" and press enter on the console. (See!topic/openhab/QgABTJAkHOg if you're getting "Could not find or load main class org.eclipse.emf.mwe2.launch.runtime.Mwe2Launcher").
  9. All your project in the workspace should now correctly compile without errors. If you still see error markers, try a "clean" on the concerned projects. If there are still errors, it could be that you use JDK 1.6 instead of JDK 1.7, or the JDK compliance is set to 1.4 or 1.5 instead of at least 1.6.
  10. To launch openHAB from within your IDE, go to Run->Run Configurations->Eclipse Application->openHAB Runtime (resp. openHAB Designer). Switch to "Plug-in Development" perspective first (Windows->Open Perspective->Other->Plug-in Development).

After the first successful local build it might be a good idea to build with maven -o (offline) afterwards. This option accelerates the project dependency resolution by 10-20x since it lets maven search it's local repository. Normally, snapshot-enabled projects are using external repositories to find latest built packages.

Note that the IDE being installed by the above mentioned method does not contain any code generation facilities (MWE, Xtext) itself since that setup caused difficulties on certain machines. The code generation is accomplished through the maven build though.

'Vagrant' Instructions

Alternatively, you may wish to use vagrant to get a pre-configured, running IDE.

  1. Install VirtualBox and vagrant first.
  2. Create a new directory for vagrant and cd into it
  3. Run vagrant init rub-a-dub-dub/openhabdev32
  4. Execute vagrant up (this will take some time as a ~3GB virtual image needs to be downloaded)
  5. Execute vagrant ssh to access your machine

To turn off the vagrant machine, run vagrant halt in the vagrant directory you created. Run vagrant suspend to just suspend the machine. To get rid of the VM and its resources, run vagrant destroy. For more information on the setup and use of the IDE with vagrant, look here.

feature overview


Setup intro

Linux and OS X





User Interfaces



(link to openHAB forum)



Application Integration



A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules


Syntax highlighting for external editors

Release Notes

Clone this wiki locally
You can’t perform that action at this time.