Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

homebridge-config-ui-x

Package Overview
Dependencies
Maintainers
1
Versions
2076
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

homebridge-config-ui-x

Configuration UI plugin for Homebridge

  • 2.3.1
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

npm

Homebridge Config UI X

This is a plugin for Homebridge. This is a fork of the work originally done by mkellsy.

This plugin allows you to monitor, backup and configure your Homebridge server from a browser.

Status

Installation Instructions

npm install -g --unsafe-perm homebridge-config-ui-x

Live Demo

https://homebridge-ui-demo.oz.nu

  • Username: admin
  • Password: admin

The demo environment is reset every 15 minutes. You might notice some high latency when using this demo as it's hosted in Australia.

Configuration

Add this to your homebridge config.json file

"platform":[
    {
      "platform": "config",
      "name": "Config",
      "port": 8080,
      "sudo": false
    }
]

Optional Settings

  • log - See below for details.
  • sudo - See below for details.
  • restart - The command to run when a restart request is sent from the browser. If not populated it will just terminate the Homebridge process and let your process manager (like systemd) restart it.
  • temp - The path to the file that can display your current CPU temperature. eg. /sys/class/thermal/thermal_zone0/temp

Log Viewer Configuration

Homebridge Config UI X allows you to view the homebridge process logs in the browser. These logs can be loaded from a file or from a command.

Logs From File

Example loading logs from a file, change /var/log/homebridge.log to the actual location of your log file:

"platform":[
    {
      "platform": "config",
      "name": "Config",
      "port": 8080,
      "log": "/var/log/homebridge.log"
    }
]

Make sure the user which is running the Homebridge process has the correct permissions to read the log file. You may need to enable the sudo option to avoid permission errors if you are not running Homebridge as root.

Logs From Systemd

If you are using systemd to manage the Homebridge process then you can just set log to systemd:

"platform":[
    {
      "platform": "config",
      "name": "Config",
      "port": 8080,
      "restart": "sudo -n systemctl restart homebridge",
      "log": "systemd"
    }
]

This will only work if your systemd service has the name homebridge. You may need to enable the sudo option to avoid permission errors if you are not running Homebridge as root.

Logs From Custom Command

The log option can alternatively specify a command to spawn that will stream the logs to the client. This command should stream the logs to stdout:

"platform":[
    {
      "platform": "config",
      "name": "Config",
      "port": 8080,
      "log": {
        "tail": "sudo -n tail -n 100 -f /var/log/homebridge.log"
      }
    }
]

Sudo Mode

Many operations performed by Homebridge Config UI X, such as installing plugins, upgrading Homebridge and viewing the logs can require root permissions. You can run the Homebridge service as root or you can enable the sudo option in the config.

"platform":[
    {
      "platform": "config",
      "name": "Config",
      "port": 8080,
      "sudo": true
    }
]

When sudo mode is enabled Homebridge Config UI X will use sudo when executing installing, removing or upgrading plugins, viewing the logs using the Logs From File or Logs From Systemd method, and when upgrading Homebridge. It will not be used for Logs From Custom Command or custom restart commands.

Password-less sudo required

For sudo mode to work password-less sudo is required. You can enable password-less sudo by adding this entry to the bottom of your /etc/sudoers file (use visudo to edit the file!):

homebridge    ALL=(ALL) NOPASSWD: ALL

Replace homebridge with the actual user you are running Homebridge as.

Initial Run

Once installed you can open the interface at http://localhost:8080. The default username is admin and the default password is admin.

Usage

Status Screen

This shows you that the services are running. It also has your HomeKit pin.

Status

Log Screen

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

Log

Plugin Screen

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

Log

When installing, removing or upgrading plugins the output is show in the browser to help troubleshoot any issues.

Log

Configuration Screen

And finally the configuration screen allows you to modify your Homebridge settings and your platforms and accessories.

Config

Supported Browsers

The following browsers are supported by this plugin:

  • Safari >= 10
  • Chrome >= 55 (including Opera)
  • MS Edge >= 13 on the desktop
  • iOS >=10 and Chrome on mobile

MS Internet Explorer (any version) is not supported!

Keywords

FAQs

Package last updated on 21 Jan 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc