openhab/openhab-distro 4.3.0

openHAB 4.3.0

on GitHub

This is the official release of openHAB 4.3.0.

The binaries are available on our download page and via "Stable" on our APT repository.

New and Noteworthy

The openHAB 4.3 release is a feature release that contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons. You can find the most relevant ones listed in detail below.

Please also note our release blog post, which describes the major new features in depth.

openHAB 4.3 is backward compatible to openHAB 4.x setups - there are only a few exceptions where manual action is required to adapt an existing setup, so please carefully check the section on breaking changes.

Quick links:

• Notes about new add-ons
• Notes about the core runtime
• Notes about the UIs
• Notes about the add-ons
• Upgrade Process for openHABian, APT, RPM, Manual Installations
• Breaking Changes that require manual interaction after the upgrade.

Relevant Changes

New Add-ons

The following add-ons are newly introduced:

Runtime

The following improvements were made to the core and the distro:

User Interfaces

Add-ons

Upgrade Process

Backup your configuration

If you are on openHABian, sudo openhabian-config menu option 50 will do for you,
else use sudo openhab-cli backup. Get the resulting file from $OPENHAB_USERDATA/backups, $OPENHAB_USERDATA is accessible as a Samba share. Using SSH it is /var/lib/openhab/ on your system.

If you run a Raspberry, get another SD card (an "Endurance" labelled one) and create a mirror copy.
openhabian-config menu option 54 will do for you on the live system, else there's tools such as dd or WinDiskImager.
Should you ever need to revert to your old openHAB system or to redo the upgrade process, simply change SD cards and start over from where you had started.

openHABian

If you are working with an openHABian setup,

1. Use SSH to connect to the command line and run sudo openhabian-config.
2. When being asked, answer that you want to update openHABian (note that’s not about openHAB itself).
3. If needed check which version you run via menu option 00.
4. If on Raspberry, create an image copy of your SD card using menu option 54.
5. Switching to openHAB 4.3.0 release depends on what version you’re upgrading from:
   
   a) If you have been running a 4.x release version, select menu entry 03 “Install or upgrade to latest openHAB” option.
   
   b) If you have been running a snapshot or milestone release of 4.3, select the first entry in menu option 41 (“Release”).

Package-based Installations

APT (Debian / Ubuntu and derivatives)

Make sure that openHAB is sourced from the latest location, has the correct GPG signing key and that your system can download .deb packages via HTTPS by following the instructions for a stable installation in the docs.

If the above is correct, simply upgrade by using:

sudo apt-get update
sudo apt-get upgrade

Alternatively, you can force apt to install 4.3.0 and its optional add-ons with:

sudo apt-get install openhab=4.3.0-1

## optional add-ons for offline installation ##
sudo apt-get install openhab-addons=4.3.0-1

RPM

openHAB is also distributed in RPM packages. To use them, make sure that openHAB is sourced from the latest location, and has the correct GPG signing key for verification by following the stable installation instructions outlined in the docs.

If the above is correct, then simply upgrade using your systems package manager (yum, dnf, etc.)

sudo yum update

Alternatively, you can force apt to install 4.3.0 and its optional add-ons with:

sudo yum install openhab-4.3.0-1

## optional add-ons for offline installation ##
sudo yum install openhab-addons-4.3.0-1

Manual Installations

Official update scripts are available that let you update your 4.x installation to version 4.3:

Linux/macOS

1. Change to your openHAB root directory (e.g. cd /opt/openhab)
2. Create a backup by calling sudo ./runtime/bin/backup.
3. Run the update command:

sudo ./runtime/bin/update 4.3.0

Windows

1. Make a backup of your openHAB installation folder.
2. Run PowerShell as administrator and change to your openHAB root directory (e.g. cd C:\openHAB)
3. Run the update command:

. .\runtime\bin\update.ps1
Update-openHAB -OHVersion 4.3.0

Breaking Changes that Require Manual Interaction after the Upgrade

Changes in Core

• The sendFrequency parameter for Slider and Colorpicker sitemap elements has been removed.
• The DateTimeType methods toZone(zone), toLocaleZone() and getZonedDateTime() have been deprecated. They will be removed in a future version. In DSL rules, please use getZonedDateTime(ZoneId) as replacement for getZonedDateTime(), for example getZonedDateTime(ZoneId.systemDefault()) to use system time-zone.

Changes in Add-ons

ElectroluxAir Binding

• The binding has been removed since the Electrolux Delta API has been discontinued.

JavaScript Automation

• The isJsInstanceOfJavaType method of the utils namespace has been removed. Use JavaScript's instanceof operator instead.

MeteoAlerte Binding

• The underlying API stopped delivering data in May 2023. Binding has been removed and is now replaced by Météo France Binding based on a new API.

MQTT Binding (Home Assistant)

• Thing types and channel IDs have been significantly restructured and simplified. Delete and re-create your things to opt in to the new style. In a subsequent openHAB release, existing things will also convert to the new style.
• Legacy schema vacuums are no longer supported.

Pentair Binding

• EasyTouch thing has been renamed to more generic Controller and all channels have been organized into groups. You will need to reconfigure your setup to the new thing structure.