integration platform for home automation
Project homepage: https://www.openhab.org/
Description
The open Home Automation Bus (openHAB) project aims at providing a
universal integration platform for all things around home automation.
It is a pure Java solution, fully based on OSGi.
It is designed to be vendor-neutral as well as hardware/protocol-agnostic.
openHAB brings together different bus systems, hardware devices,
and interface protocols by dedicated bindings. These bindings send
and receive commands and status updates on the openHAB event bus.
This concept allows designing user interfaces with a unique look&feel,
but with the possibility to operate devices based on a big number
of different technologies. Besides the user interfaces, it also
brings the power of automation logic across different system
boundaries.
Package information
- Ports path
- misc/openhab/5
- Package architecture
- amd64
- Maintainer
- Chaz Kettleson <chaz@pyr3x.com>
- Categories
- misc, java
- Available flavors
- None listed
- Only for architectures
- i386, amd64, aarch64
Ports list build and test dependencies as well as runtime dependencies. pkg_add selects those needed for installation.
Direct dependencies
Runtime
- java/javaPathHelper
- devel/jdk/21 jdk->=21v0,<22v0
OpenBSD README
This README contains unresolved ports variables; replace them before using its commands.
+-------------------------------------------------------------------------------
| Running openhab on OpenBSD
+-------------------------------------------------------------------------------
Listen on localhost only
========================
openHAB is configured by sourcing environment variables from /etc/openhab.conf.
By default, openHAB listens on 0.0.0.0 port 8080 (http) and 8443 (https).
We've opted to default to 127.0.0.1 for obvious security reasons. To restore the
original behavior make the following change in /etc/openhab.conf:
OPENHAB_HTTP_ADDRESS=0.0.0.0
Refer to https://www.openhab.org/docs/ for more details.
Access to serial devices
========================
openHAB runs as user _openhab. By default, this user will not be able to access
serial devices. If, for example, you plan to access a locally connected USB
dongle for Zigbee or Z-Wave, you will need to add the _openhab user to the
'dialer' group.
Please note, you will need a library to access serial ports from Java. The
example of passing "-Dgnu.io.rxtx.SerialPorts" uses the rxtx library, which is
currently unsupported on OpenBSD. However, 100% Java implementations such as
PureJavaComm and jSerialComm are known to work.
Refer to https://www.openhab.org/docs/ for more details.
Preserve shell history
======================
By default, the openHAB console attempts to save its command history to a
directory that is not writable by the _openhab user, preventing history from
being preserved.
To enable and configure shell history, add the following property to
/var/db/openhab/etc/custom.system.properties:
karaf.history=${openhab.userdata}/.karaf/history
This evaluates to /var/db/openhab/.karaf/history. Note that this file will be
created with world-readable permissions by default. To restrict access,
pre-create the directory with secure permissions before launching the service:
# install -d -o _openhab -g _openhab -m 0750 /var/db/openhab/.karaf
Refer to https://www.openhab.org/docs/ for more details.