Skip to content


marcvk edited this page Jan 9, 2016 · 3 revisions

Installation on FreeBSD

NB Small warning, this is only for the more technically versed as it requires patching and recompiling openHAB

There are currently two known problems with running openHAB on FreeBSD out of the box.

  1. The serial package that is used by openHAB does not support FreeBSD. Fortunately it is not difficult to compile it, but it does require a number of steps.
  2. There is a "bug" (missing feature, the jury is out on that :)) in that the FreeBSD IP stack does not support mapping IPv4 multicast addresses inside IPv6 addresses. This problem occurs when setting up multicast, and impacts quite a bit of functionality. The workaround for this problem is fortunately very simple.

This procedure was tested on FreeBSD 10.2 with openHAB 1.8.0.

  1. Install openjdk8 and git on FreeBSD: pkg install openjdk8 git
  2. Install maven via ports (otherwise it's going to download jdk7 for some reason)
    1. cd /usr/ports/devel/maven33
    2. make install clean
  3. Get the openHAB sources for 1.8.0, see also IDE Setup. You can skip the parts about setting up eclipse, just get the sources and use maven to compile. Pay special attention to also cleaning before building the sources, this is required every time! Say the location for the openhab sources is $(OHSRC)
  4. Get the nrjavaserial sources from
  5. You'll also need gradle, so install that as well, again as port:
  6. cd /usr/ports/devel/gradle
  7. make install clean
  8. Apply the patches from the thread!topic/openhab/fLAs5NdLwpw. I haven't installed the patches automatically (as described in the thread), but applied them one by one by hand. It may still work, but YMMV.
  9. Build nrjavaserial (basically do 'make freebsd')
  10. Get the resulting library (for version 3.11.0) from build/libs/nrjavaserial-3.11.0.jar and copy it to $(OHSRC)/bundles/io/
  11. Change the version number in $(OHSRC)/bundles/io/ and $(OHSRC)/bundles/io/
  12. cd $(OHSRC)
  13. mvn clean
  14. mvn package
  15. wait 10 minutes
  16. The new distribution files are in $(OHSRC)/distribution/target
  17. Install openHAB as usual, see also Manual installation
  18. Edit and add the following define:
  19. Edit configurations/openhab.cfg and set the serial port to /dev/ttyU0 (or adapt if your usb device shows up on a different device)

Regarding the multicast problem

For those interested in more background, it seems the FreeBSD IP stack does not support mapping IPV4 multicast addresses inside IPV6 addresses. Here is a link to the corresponding bug report:

It turns out to be a non-trivial amount of work to fix this, and the use case is apparently not entirely clean, so resolution of the bug fix is still pending. Fortunately there is also a work-around. Adding the following define to makes it work:

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.