# homebridge-config-ui-x

> A web based management, configuration and control platform for Homebridge.

Latest version **5.30.1** (published 2026-11-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install homebridge-config-ui-x
pnpm add homebridge-config-ui-x
yarn add homebridge-config-ui-x
bun add homebridge-config-ui-x
```

Provides the command `hb-service`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 5.30.1 |
| Published | 2026-11-13 |
| First published | 2017-12-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^22.12.0 \|\| ^24.0.0 \|\| ^26.0.0 |
| Dependencies | 40 |
| Unpacked size | 13.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2812 |
| Author | oznu |
| Maintainers | oznu, northernman, supereg, khaost, ebaauw, dustin.greif, nfarina, bwp91 |
| Keywords | homebridge-plugin, ui, gui, web, homebridge, homebridge-config-ui-x, ui-x, config-ui-x, homebridge-x, homebridge server, homebridge ui, homebridge-ui, homebridge gui, homebridge-gui, web interface, config ui, management, config editor, linux, macOS, osx, windows, raspberry pi, accessory control, smart home, hb-service |

## Links

- npm: https://www.npmjs.com/package/homebridge-config-ui-x
- Repository: https://github.com/homebridge/homebridge-config-ui-x
- Homepage: https://github.com/homebridge/homebridge-config-ui-x#readme
- Issues: https://github.com/homebridge/homebridge-config-ui-x/issues
- Funding: https://github.com/sponsors/oznu
- npm.io page: https://npm.io/package/homebridge-config-ui-x

## Dependencies (40)

- [ora](https://npm.io/package/ora.md) 10.0.0
- [tar](https://npm.io/package/tar.md) 7.5.23
- [rxjs](https://npm.io/package/rxjs.md) 7.8.2
- [tail](https://npm.io/package/tail.md) 2.2.6
- [axios](https://npm.io/package/axios.md) 1.21.1
- [dayjs](https://npm.io/package/dayjs.md) 1.11.23
- [otplib](https://npm.io/package/otplib.md) 13.6.0
- [semver](https://npm.io/package/semver.md) 7.8.6
- [fastify](https://npm.io/package/fastify.md) 5.12.8
- [p-limit](https://npm.io/package/p-limit.md) 7.3.3
- [fs-extra](https://npm.io/package/fs-extra.md) 11.4.1
- [passport](https://npm.io/package/passport.md) 0.7.0
- [unzipper](https://npm.io/package/unzipper.md) 0.12.5
- [commander](https://npm.io/package/commander.md) 15.1.0
- [bash-color](https://npm.io/package/bash-color.md) 0.0.4
- [node-cache](https://npm.io/package/node-cache.md) 5.1.2
- [node-forge](https://npm.io/package/node-forge.md) 1.4.3
- [@nestjs/jwt](https://npm.io/package/@nestjs/jwt.md) 12.0.5
- [@nestjs/core](https://npm.io/package/@nestjs/core.md) 12.5.0
- [jsonwebtoken](https://npm.io/package/jsonwebtoken.md) 9.0.3
- [passport-jwt](https://npm.io/package/passport-jwt.md) 4.0.1
- [@nestjs/axios](https://npm.io/package/@nestjs/axios.md) 12.0.2
- [node-schedule](https://npm.io/package/node-schedule.md) 2.1.2
- [tcp-port-used](https://npm.io/package/tcp-port-used.md) 1.0.3
- [@nestjs/common](https://npm.io/package/@nestjs/common.md) 12.5.0
- [@fastify/helmet](https://npm.io/package/@fastify/helmet.md) 13.2.0
- [@fastify/static](https://npm.io/package/@fastify/static.md) 10.1.11
- [@nestjs/swagger](https://npm.io/package/@nestjs/swagger.md) 12.1.2
- [bonjour-service](https://npm.io/package/bonjour-service.md) 1.4.4
- [class-validator](https://npm.io/package/class-validator.md) 0.15.1
- [@nestjs/passport](https://npm.io/package/@nestjs/passport.md) 12.0.2
- [reflect-metadata](https://npm.io/package/reflect-metadata.md) 0.2.2
- [class-transformer](https://npm.io/package/class-transformer.md) 0.5.1
- [systeminformation](https://npm.io/package/systeminformation.md) 5.33.21
- [@fastify/multipart](https://npm.io/package/@fastify/multipart.md) 10.1.8
- [@nestjs/websockets](https://npm.io/package/@nestjs/websockets.md) 12.5.0
- [@homebridge/hap-client](https://npm.io/package/@homebridge/hap-client.md) 5.4.0
- [@nestjs/platform-fastify](https://npm.io/package/@nestjs/platform-fastify.md) 12.5.0
- [@nestjs/platform-socket.io](https://npm.io/package/@nestjs/platform-socket.io.md) 12.5.0
- [@homebridge/node-pty-prebuilt-multiarch](https://npm.io/package/@homebridge/node-pty-prebuilt-multiarch.md) 0.15.0

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 5.30.1 (latest) — 2026-11-13
- 6.0.2-alpha.0 (alpha) — 2026-11-21
- 5.30.2-beta.10 (beta) — 2026-11-21
- 4.80.0 (release-4.x) — 2025-07-12
- 5.30.2-beta.9 — 2026-11-19
- 6.0.1-alpha.26 — 2026-11-18
- 6.0.1-alpha.25 — 2026-11-18
- 5.30.2-beta.8 — 2026-11-18
- 5.30.2-beta.7 — 2026-11-18
- 5.30.2-beta.6 — 2026-11-17
- 5.30.2-beta.5 — 2026-11-17
- 5.30.2-beta.4 — 2026-11-17
- 6.0.1-alpha.24 — 2026-11-17
- 5.30.2-beta.3 — 2026-11-16
- 5.30.2-beta.2 — 2026-11-16
- … 2860 more at https://npm.io/package/homebridge-config-ui-x/versions

## README

<p align="center">
  <a href="https://homebridge.io"><img src="https://raw.githubusercontent.com/homebridge/branding/latest/logos/homebridge-color-round-stylized.png" alt="Homebridge Logo" height="140"></a>
</p>
<span align="center">

# Homebridge UI

[![npm](https://img.shields.io/npm/v/homebridge-config-ui-x/latest?label=latest)](https://www.npmjs.com/package/homebridge-config-ui-x)
[![npm](https://img.shields.io/npm/v/homebridge-config-ui-x/beta?label=beta)](https://www.npmjs.com/package/homebridge-config-ui-x)
[![npm](https://img.shields.io/npm/dt/homebridge-config-ui-x?label=downloads)](https://www.npmjs.com/package/homebridge-config-ui-x)

:gb: :bulgaria: :cn: :taiwan: :czech_republic: :finland: :fr: :de: :hungary: :indonesia: :israel: :it: :jp: :kr: :macedonia: :netherlands: :norway: :poland: :portugal: :brazil: :ru: :slovenia: :es: :sweden: :thailand: :tr: :ukraine: :vietnam:

</span>

**Homebridge UI** is a web-based management tool for [Homebridge](https://github.com/homebridge/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 500 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
- Back up and Restore your Homebridge instance
- Set up and manage your Homebridge plugins as [child bridges](https://github.com/homebridge/homebridge/wiki/Child-Bridges)
- and more...

Homebridge UI also provides a tool called [`hb-service`](https://github.com/homebridge/homebridge-config-ui-x/wiki/Homebridge-Service-Command) which makes it easy to set up Homebridge as a service on Linux/Raspbian, macOS, FreeBSD and Windows.

## Installation Instructions

For detailed instructions on how to set up Node.js and Homebridge with Homebridge UI as a service, see the guides on the wiki:

- <img src="https://user-images.githubusercontent.com/3979615/78118327-9853f200-7452-11ea-88aa-5e57ebcf3070.png" alt="homebridge-raspbian-image" height="16px" width="16px"/> [Setup Homebridge using the official Homebridge Raspberry Pi Image](https://github.com/homebridge/homebridge-raspbian-image/wiki/Getting-Started)
- <img src="https://user-images.githubusercontent.com/3979615/59594350-07b45b80-9137-11e9-85fd-e75093ba91a4.png" alt="raspbian" height="16px" width="16px"/> [Setup Homebridge on a Raspberry Pi (Raspberry Pi OS)](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Raspbian)
- <img src="https://user-images.githubusercontent.com/3979615/59595664-93c78280-9139-11e9-83dc-4d6f9405e788.png" alt="linux" height="16px" width="16px"/> [Setup Homebridge on Debian or Ubuntu Linux](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Debian-or-Ubuntu-Linux)
- <img src="https://user-images.githubusercontent.com/3979615/59595664-93c78280-9139-11e9-83dc-4d6f9405e788.png" alt="linux" height="16px" width="16px"/> [Setup Homebridge on Red Hat, CentOS or Fedora Linux](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Red-Hat%2C-CentOS-or-Fedora-Linux)
- <img src="https://user-images.githubusercontent.com/3979615/59595664-93c78280-9139-11e9-83dc-4d6f9405e788.png" alt="linux" height="16px" width="16px"/> [Setup Homebridge on Arch / Manjaro Linux](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Arch-Linux)
- <img src="https://github.com/user-attachments/assets/c305ca8b-146c-4d43-98b6-ebabb23be290" alt="vm" height="16px" width="16px"/> [Setup Homebridge using a Virtual Machine (recommended for Windows and macOS)](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Virtual-Machine)
- <img src="https://user-images.githubusercontent.com/3979615/59593218-e0f52580-9134-11e9-8b77-585755af5d99.png" alt="windows" height="16px" width="16px"/> [Setup Homebridge on Windows 10/11](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Windows-10)
- <img src="https://user-images.githubusercontent.com/3979615/59594157-b015f000-9136-11e9-93cb-c9d9773ec9e8.png" alt="macos" height="16px" width="16px"/> [Setup Homebridge on macOS](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-macOS)
- <img src="https://user-images.githubusercontent.com/3979615/59594527-56fa8c00-9137-11e9-937b-32092dfcff41.png" alt="docker" height="16px" width="16px"/> [Setup Homebridge using Docker](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Docker)
- <img src="https://user-images.githubusercontent.com/3979615/78118531-dc46f700-7452-11ea-95e5-977f79d1904f.png" alt="synology-dsm" height="16px" width="16px"/> [Setup Homebridge on a Synology NAS](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Synology-DSM)

If your platform is not listed above, see [Other Platforms](https://github.com/homebridge/homebridge/wiki/Other-Platforms). If you want to use your own service manager, see the [Manual Configuration](https://github.com/homebridge/homebridge-config-ui-x/wiki/Manual-Configuration) wiki article for instructions on installing and running `hb-service` manually.

The default username is `admin` and the default password is `admin`.

The UI can be accessed via web browser by default on port `8581` (e.g. `http://localhost:8581`).

## Usage

### Status Screen

This shows an overview of your Homebridge system. The dashboard is widget-based and completely customisable with a number of themes available.

![Status](screenshots/homebridge-config-ui-x-status.png)

### Plugin Screen

This shows you the currently installed plugins and allows you to install, configure, update, and remove plugins.

![Plugin](screenshots/homebridge-config-ui-x-darkmode-plugins.png)

You can configure supported plugins using the graphical settings editor or by editing the config JSON directly.

![Plugin Settings](screenshots/homebridge-config-ui-x-darkmode-alexa-settings.png)

### Configuration Screen

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.

![Config](screenshots/homebridge-config-ui-x-config.png)

### Log Screen

This shows you the Homebridge rolling log. This is helpful for troubleshooting.

![Log](screenshots/homebridge-config-ui-x-logs.png)

### Accessories Screen

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.

![Accessories](screenshots/homebridge-config-ui-x-accessories.png)

## Plugin Development

The https://developers.homebridge.io website contains the Homebridge API reference, available service and characteristic types, and plugin examples.

The [Homebridge Plugin Template](https://github.com/homebridge/homebridge-plugin-template) project provides a base you can use to create your own _platform_ plugin.

There are many existing plugins you can study; you might start with the [Homebridge Example Plugins](https://github.com/homebridge/homebridge-examples) or a plugin that already implements the device type you need.

## Community

The official Homebridge Discord server and Reddit community are where users can discuss Homebridge and ask for help.

<span align="center">

[![Homebridge Discord](https://discordapp.com/api/guilds/432663330281226270/widget.png?style=banner2)](https://discord.gg/kqNCe2D) [![Homebridge Reddit](https://raw.githubusercontent.com/homebridge/homebridge/50f91541bc8731ed0c794f1370d9b76f49443d11/.github/homebridge-reddit.svg)](https://www.reddit.com/r/homebridge/)

</span>

HomeKit communities can also be found on both [Discord](https://discord.gg/RcV7fa8) and [Reddit](https://www.reddit.com/r/homekit).

## Limitations

- One bridge can only expose 150 accessories due to a HomeKit limit. You can, however, run your plugins as a [Child Bridge](https://github.com/homebridge/homebridge/wiki/Child-Bridges) to get around this limitation.
- Once an accessory has been added to the Home app, changing its name via Homebridge won't be automatically reflected in iOS. You must change it via the Home app as well.

## Credits

- Homebridge was originally created by [Nick Farina](https://twitter.com/nfarina).
- The original HomeKit API work was done by [Khaos Tian](https://twitter.com/khaost) in his [HAP-NodeJS](https://github.com/homebridge/HAP-NodeJS) project.
- Homebridge UI was originally created by [oznu](https://github.com/oznu).

---
_Source: https://npm.io/package/homebridge-config-ui-x · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
