How To Test Upcoming Changes

How To Test Upcoming Changes

How To Test Upcoming Changes

How To Test Upcoming Changes

How To Test Upcoming Changes

How To Test Upcoming Changes

How To Test Upcoming Changes

Node.js Version

• ️⚠️ The hb-service backend now has a stricter Node.js version requirement:
  • if you are running Node.js v20, then you must be running at least v20.19.0
  • if you are running Node.js v22, then you must be running at least v22.12.0
  • if you are running Node.js v24, then you must be running at least v24.0.0
    • although remember that v24 is not officially supported yet
• The UI will not allow you to update to UI v5.2.0 if you are running an unsupported version of Node.js
• Check the Homebridge Wiki for instructions on how to update Node.js on your system

Other Changes

• update node engines to ^20.19.0 || ^22.12.0 || ^24.0.0

Homebridge Dependencies

• @homebridge/hap-client @ v3.0.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.13.1
• @homebridge/plugin-ui-utils @ v2.1.0

⚠️ Do not update if:

• you are running Node.js v20, and your version is lower than v20.19.0
• you are running Node.js v22, and your version is lower than v22.12.0

UI Changes

• only show hbv2 readiness icon when ready to show
• migrate to use fetch() for http requests
• Fix alignment of Plugin Updates in Horizontal Mode (#2495) (@NorthernMan54)
• offer to download a backup before updating homebridge/ui
• updates to the he.json language file (@seidnerj)
• pass through plugin display name to logs after update
• fix accidental hiding of startup settings section

Homebridge Dependencies

• @homebridge/hap-client @ v3.0.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.13.1
• @homebridge/plugin-ui-utils @ v2.1.0

⚠️ Breaking Changes

• This version of the Homebridge UI:
  • Is compatible with Homebridge v1 and v2-beta, with no plans to drop support for Homebridge v1 in the near future.
  • Drops support for Node.js v18 and earlier, so please update to v20 or v22 - more info on updating
  • Drops support for Raspberry Pi devices running on the armv6 architecture (like the Pi 1 and Pi Zero) - please update your hardware
  • Drops support for instances using pnpm as the package manager - consider updating your Homebridge instance to use npm instead - more info on updating

UI Changes

• updates to the fi.json language file (#2253) (@l1500s)
• update default dashboard layout
• add support for dark mode switching with custom plugin uis (@NorthernMan54)
• Display Docker Version Details in the Update Information Box (#2488) (@NorthernMan54)
• allow to reinstall installed versions of plugins

Other Changes

• improvements to the deprecate versions workflow
• retire use of pnpm and code references
• bump the default node version from 20 to 22
• make terminal enabled by default on new macOS hb-service installs
• set service mode as default, remove standalone
• Initial support for NodeJS 24 in preparation for LTS in Fall of 2025 (#2451) (@NorthernMan54)
• update fastify and nestjs dependencies

Homebridge Dependencies

• @homebridge/hap-client @ v3.0.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.13.1
• @homebridge/plugin-ui-utils @ v2.1.0