How to best update from 3.3.0 to 4.0.2?

I have a manual 3.3.0 installation on Linux and I wonder what is better/less error-prone:

  • update 3.3.0 first to 3.4.5, check/fix everything and then update to 4.0.2
  • update 3.3.0 directly to 4.0.2


first update to 3.4.5, then hold version, upgrade system to current version (which Distro? Hardware?), check that openHAB3.4.5 is still working, then update to Java17 (openHAB3.4 is Java17 compatible).
After updating to Java17 (and openHAB3.4.5 still working…) , unhold the openHAB version and upgrade to 4.0.2, which will result in an upgrade with automatic changes in configuration - of course you will still have to care about some parts of the configuration.

1 Like

Thanks for the quick response.
This is a manual installation (no openHAB distro) on Gentoo Linux.
So, I should first update to 3.4.5 and check that everything is working and then do the next update to 4.0.2.

Yes, for sure.
In fact, this is the correct way to do it even on an openHABian (i.e. the only official openHAB “distro-like” thing) system.

1 Like

Cool, thanks!

I’m running v3.3, how do I first upgrade to 3.4.5? If I use openhabian-config I’m afraid I get v4.0, isn’t it? Thx

I’m not sure if there is an easy way with openhabian-config, but you can use apt to do it:

sudo apt update
apt-cache showpkg openhab | grep 3.4.5

this should result in a list of all available versions with 3.4.5 in the name. Select the highest available version (not sure, maybe 3.4.5-2?)
For example, sudo apt install openhab=3.4.5-2 will install version 3.4.5 (patch 1, as -1 is the unpatched version)

Please take a look at the ChangeLogs:

please take care of EVERY change log since 3.3.0 (no need to read entirely, but search for every breaking change and every binding you are using)
Keep in mind that the releases are not sorted as version ascending but as publishing date ascending, so there are many 4.0.x versions between all releases from 3.3.0 to 3.4.5