This repository provides Homebrew formulae to install openHAB with the Homebrew Package Manager on macOS (and Linux).

For information about the general openHAB package, please visit the openhab-distro GitHub repo. For general information about openHAB, please visit the openHAB homepage.

If you are on Linux, it is recommended to use the APT or RPM packages, as APT and RPM are way more sophisticated than our Homebrew formulae.

Add the openhab/openhab tap to Homebrew:

brew tap openhab/openhab

Next, install a version of openHAB:

# openHAB stable:
brew install openhab
# openHAB milestone:
brew install openhab-milestone

The openhab/openhab-milestone formulae automatically installs the openhab-cli tool and OpenJDK as JRE. It is recommended to pin the openHAB formula version, as openHAB upgrades can potentially include breaking changes:

# openHAB stable:
brew pin openhab
# openHAB milestone:
brew pin openhab-milestone

On macOS, the OpenJDK formula version should be pinned as well, because after a OpenJDK upgrade, the Local Network Access permission needs to be granted again through Settings -> Privacy & Security -> Local Network:

brew pin openjdk@21

Information about the formula, e.g. how to enable the service, can be retrieved with brew info openhab resp. brew info openhab-milestone.

To install a previous stable version, you can check out the tagged version of the tap (example for openHAB 5.0):

git -C $(brew --prefix)/Library/Taps/openhab/homebrew-openhab checkout v5.0 Formula/openhab.rb

To switch back to the HEAD of the tap (i.e. current stable or milestone), you can run:

git -C $(brew --prefix)/Library/Taps/openhab/homebrew-openhab checkout main && git -C $(brew --prefix)/Library/Taps/openhab/homebrew-openhab pull

As mentioned by brew info openhab resp. brew info openhab-milestone, you can enable the service with brew services start openhab resp. brew services start openhab-milestone. This starts the service formula immediately and registers it to launch at login (or boot).

The openHAB CLI tool known from the Deb/Rpm packages is also available via Homebrew:

$ openhab-cli

Usage:  openhab-cli command [options]

Possible commands:
  backup [--full] [filename]   -- Stores the current configuration of openHAB.
  clean-cache                  -- Cleans the openHAB temporary folders.
  console                      -- Opens the openHAB console.
  info                         -- Displays distribution information.
  restore [--textconfig] [--uiconfig] filename
                               -- Restores openHAB configuration from a backup.
  showlogs                     -- Displays the log messages of openHAB.
  start [--debug]              -- Starts openHAB in the terminal.
  status                       -- Checks to see if openHAB is running.
  stop                         -- Stops any running instance of openHAB.

... [WARN ] [org.apache.felix.fileinstall] - /usr/share/openhab/addons does not exist, please create it.
... [ERROR] [org.apache.felix.fileinstall] - Cannot create folder /var/lib/openhab/tmp/bundles. Is the folder write-protected?

When observing log messages like the above on startup, ensure proper felix.fileinstall.dir and felix.fileinstall.dir are set in /opt/homebrew/var/lib/openhab/config/org/apache/felix/fileinstall/*.config.

• openHAB
• Homebrew: brew help, man brew or check Homebrew's documentation
• Homebrew Formula: Check the Homebrew Formula Cookbook