Supported Languages: ๐ฌ๐ง ๐ฉ๐ช ๐ซ๐ท ๐ต๐ฑ ๐จ๐ฟ ๐ท๐บ ๐จ๐ณ ๐ญ๐บ ๐ฏ๐ต ๐ช๐ธ ๐ณ๐ฑ ๐น๐ท ๐ฎ๐น ๐ง๐ฌ ๐ธ๐ช ๐ณ๐ด ๐ธ๐ฎ ๐ง๐ท ๐ต๐น ๐ฎ๐ฉ ๐ฐ๐ท ๐ฒ๐ฐ ๐น๐ญ ๐ฎ๐ฑ ๐บ๐ฆ
Homebridge Config UI X is a web based management tool for Homebridge that allows you to manage all aspects of your Homebridge setup.
- Install and configure Homebridge plugins
- Edit the Homebridge
config.json
with advanced JSON syntax checking and structure validation - Visual configuration for over 450 plugins (no manual config.json editing required)
- Monitor your Homebridge server via a fully customisable widget-based dashboard
- View the Homebridge logs
- View and control Homebridge accessories
- Restart Homebridge
- Backup and Restore your Homebridge instance
- and more...
Homebridge Config UI X also provides a tool called hb-service
which makes it easy to setup Homebridge as a service on Linux/Raspbian, macOS and Windows 10.
For detailed instructions on how to setup Node.js and Homebridge with Homebridge Config UI X as a service see the guides on the wiki:
Setup Homebridge using the official Homebridge Raspberry Pi Image
Setup Homebridge on a Raspberry Pi (Raspbian)
Setup Homebridge on Debian or Ubuntu Linux
Setup Homebridge on Windows 10
Setup Homebridge on macOS
Setup Homebridge using Docker
Setup Homebridge on a Synology NAS
If your platform is not listed above, or you want to use your own service manager, see the Manual Configuration wiki article for instructions on setting up the Homebridge UI to run as a Homebridge plugin instead of a service.
The default username is admin
and the default password is admin
.
The UI can be accessed via web browser by default on port 8581
(eg. http://localhost:8581
).
This shows an overview of your Homebridge system. The dashboard is widget based and completely customisable with a number of themes available.
This shows you the currently installed plugins and allows you to install, remove and upgrade plugins.
You can configure supported plugins using the graphical settings editor, removing the need to manually edit the config.json
. Over 165 popular plugins have implemented support for this feature.
The configuration screen allows you to modify your Homebridge config.json
. The built in editor automatically syntax-checks your JSON and makes a backup of your config every time you make a change.
This shows you the Homebridge rolling log. This is helpful for troubleshooting.
This shows you the Homebridge accessories for all the Homebridge instances on your network. You can use this to control accessories from a web browser and works well on mobile devices which allows users to control Homebridge from non-Apple devices.
The following browsers are supported by the Homebridge UI:
- Chrome - latest
- Edge - latest
- Firefox - latest
- Safari - 2 most recent major versions
- iOS - 2 most recent major versions
MS Internet Explorer (any version) is not supported!
While the Homebridge UI should work on Node.js 14+, only the following versions of Node.js are officially supported:
- node v14.15.0 or higher
- npm v6.4.1 or higher
You can check your current versions using these commands:
# check node version
node -v
# check npm version
npm -v
Please see CONTRIBUTING.md.
Make sure you installed the package with sudo
and used the --unsafe-perm
flag. Most installation errors can be fixed by removing the Homebridge UI and reinstalling:
# cleanup
sudo npm uninstall -g homebridge-config-ui-x
# reinstall
sudo npm install -g --unsafe-perm homebridge-config-ui-x
Make sure you are running supported versions of node and npm.
If the Accessories tab is not shown then you are not running Homebridge in insecure mode. See the Enabling Accessory Control wiki for details. If you have just enabled insecure mode make sure you have restarted Homebridge and refreshed the page in your browser.
The Homebridge UI supports the homebridge/homebridge Docker image. You must enable the UI using the method described in the wiki.
Join the Official Homebridge Discord community and ask in the #ui channel.
Homebridge Config UI X was originally created by oznu.