config.schema.json

{
  "pluginAlias": "config",
  "pluginType": "platform",
  "singular": true,
  "schema": {
    "type": "object",
    "properties": {
      "name": {
        "title": "Name",
        "type": "string",
        "default": "Homebridge UI",
        "minLength": 1,
        "required": true,
        "description": "The name of the Homebridge instance."
      },
      "port": {
        "title": "Port",
        "type": "integer",
        "default": 8080,
        "maximum": 65535,
        "required": true,
        "description": "The port number to run the Homebridge UI on."
      },
      "auth": {
        "title": "Homebridge UI Authentication",
        "type": "string",
        "default": "form",
        "description": "The type of authentication to use for the Homebridge UI.",
        "oneOf": [
          {
            "title": "Require Authentication",
            "enum": [
              "form"
            ]
          },
          {
            "title": "None",
            "enum": [
              "none"
            ]
          }
        ],
        "required": true
      },
      "theme": {
        "title": "UI Theme",
        "description": "The theme used for the UI.",
        "type": "string",
        "default": "auto",
        "oneOf": [
          {
            "title": "Default (Auto Dark Mode)",
            "enum": [
              "auto"
            ]
          },
          {
            "title": "Red",
            "enum": [
              "red"
            ]
          },
          {
            "title": "Pink",
            "enum": [
              "pink"
            ]
          },
          {
            "title": "Purple",
            "enum": [
              "purple"
            ]
          },
          {
            "title": "Purple - Deep",
            "enum": [
              "deep-purple"
            ]
          },
          {
            "title": "Indigo",
            "enum": [
              "indigo"
            ]
          },
          {
            "title": "Blue",
            "enum": [
              "blue"
            ]
          },
          {
            "title": "Blue - Navi",
            "enum": [
              "navi-blue"
            ]
          },
          {
            "title": "Blue Grey",
            "enum": [
              "blue-grey"
            ]
          },
          {
            "title": "Cyan",
            "enum": [
              "cyan"
            ]
          },
          {
            "title": "Green",
            "enum": [
              "green"
            ]
          },
          {
            "title": "Teal",
            "enum": [
              "teal"
            ]
          },
          {
            "title": "Orange",
            "enum": [
              "orange"
            ]
          },
          {
            "title": "Amber",
            "enum": [
              "amber"
            ]
          },
          {
            "title": "Grey",
            "enum": [
              "grey"
            ]
          },
          {
            "title": "Brown",
            "enum": [
              "brown"
            ]
          },
          {
            "title": "Dark Mode - HomeKit Orange",
            "enum": [
              "dark-mode"
            ]
          },
          {
            "title": "Dark Mode - Red",
            "enum": [
              "dark-mode-red"
            ]
          },
          {
            "title": "Dark Mode - Pink",
            "enum": [
              "dark-mode-pink"
            ]
          },
          {
            "title": "Dark Mode - Purple",
            "enum": [
              "dark-mode-purple"
            ]
          },
          {
            "title": "Dark Mode - Indigo",
            "enum": [
              "dark-mode-indigo"
            ]
          },
          {
            "title": "Dark Mode - Blue",
            "enum": [
              "dark-mode-blue"
            ]
          },
          {
            "title": "Dark Mode - Blue Grey",
            "enum": [
              "dark-mode-blue-grey"
            ]
          },
          {
            "title": "Dark Mode - Green",
            "enum": [
              "dark-mode-green"
            ]
          },
          {
            "title": "Dark Mode - Grey",
            "enum": [
              "dark-mode-grey"
            ]
          },
          {
            "title": "Dark Mode - Brown",
            "enum": [
              "dark-mode-brown"
            ]
          },
          {
            "title": "Dark Mode - Teal",
            "enum": [
              "dark-mode-teal"
            ]
          },
          {
            "title": "Dark Mode - Cyan",
            "enum": [
              "dark-mode-cyan"
            ]
          }
        ],
        "required": true
      },
      "restart": {
        "title": "Custom Restart Command",
        "type": "string",
        "description": "If no restart command is set the process will terminate with a non-zero exit code.",
        "placeholder": "eg. sudo systemctl restart homebridge"
      },
      "temp": {
        "title": "Path to OS Temp File",
        "type": "string",
        "placeholder": "eg. /sys/class/thermal/thermal_zone0/temp",
        "description": "If you are running Homebridge on a Raspberry Pi, you can enter the path to the OS temp file here. This will display the current temperature on the Homebridge status page."
      },
      "tempUnits": {
        "title": "Temperature Display Units",
        "description": "The units used to display the temperature.",
        "type": "string",
        "required": true,
        "default": "c",
        "oneOf": [
          {
            "title": "Celsius",
            "enum": [
              "c"
            ]
          },
          {
            "title": "Fahrenheit",
            "enum": [
              "f"
            ]
          }
        ]
      },
      "lang": {
        "title": "Language",
        "type": "string",
        "default": "auto",
        "description": "The language used for the UI.",
        "required": true,
        "oneOf": [
          {
            "title": "Automatic (Use Browser Settings)",
            "enum": [
              "auto"
            ]
          },
          {
            "title": "Bulgarian (bg)",
            "enum": [
              "bg"
            ]
          },
          {
            "title": "Catalan (ca)",
            "enum": [
              "ca"
            ]
          },
          {
            "title": "Chinese - Simplified (zh-CN)",
            "enum": [
              "zh-CN"
            ]
          },
          {
            "title": "Chinese - Traditional (zh-TW)",
            "enum": [
              "zh-TW"
            ]
          },
          {
            "title": "Czech (cs)",
            "enum": [
              "cs"
            ]
          },
          {
            "title": "Dutch (nl)",
            "enum": [
              "nl"
            ]
          },
          {
            "title": "English (en)",
            "enum": [
              "en"
            ]
          },
          {
            "title": "French (fr)",
            "enum": [
              "fr"
            ]
          },
          {
            "title": "German (de)",
            "enum": [
              "de"
            ]
          },
          {
            "title": "Hebrew (he)",
            "enum": [
              "he"
            ]
          },
          {
            "title": "Hungarian (hu)",
            "enum": [
              "hu"
            ]
          },
          {
            "title": "Indonesian (id)",
            "enum": [
              "id"
            ]
          },
          {
            "title": "Italian (it)",
            "enum": [
              "it"
            ]
          },
          {
            "title": "Japanese (ja)",
            "enum": [
              "ja"
            ]
          },
          {
            "title": "Korean (ko)",
            "enum": [
              "ko"
            ]
          },
          {
            "title": "Macedonian (mk)",
            "enum": [
              "mk"
            ]
          },
          {
            "title": "Norwegian (no)",
            "enum": [
              "no"
            ]
          },
          {
            "title": "Polish (pl)",
            "enum": [
              "pl"
            ]
          },
          {
            "title": "Portuguese (Brazil)",
            "enum": [
              "pt-BR"
            ]
          },
          {
            "title": "Portuguese (Portugal)",
            "enum": [
              "pt"
            ]
          },
          {
            "title": "Russian (ru)",
            "enum": [
              "ru"
            ]
          },
          {
            "title": "Slovenian (sl)",
            "enum": [
              "sl"
            ]
          },
          {
            "title": "Spanish (es)",
            "enum": [
              "es"
            ]
          },
          {
            "title": "Swedish (sv)",
            "enum": [
              "sv"
            ]
          },
          {
            "title": "Thai (th)",
            "enum": [
              "th"
            ]
          },
          {
            "title": "Turkish (tr)",
            "enum": [
              "tr"
            ]
          },
          {
            "title": "Ukrainian (uk)",
            "enum": [
              "uk"
            ]
          }
        ]
      },
      "loginWallpaper": {
        "title": "Path to Login Wallpaper Image File",
        "description": "The full path to the .jpg file.",
        "type": "string",
        "placeholder": "eg. /home/pi/mywallpaper.jpg"
      },
      "sudo": {
        "title": "Use Sudo",
        "type": "boolean",
        "description": "If you are running Homebridge as root, you may need to enable this option."
      },
      "homebridgePackagePath": {
        "title": "Path To Homebridge Module",
        "type": "string",
        "description": "If you have multiple versions of Homebridge installed, you can specify the path to the version you want to use here.",
        "placeholder": "eg. /usr/local/lib/node_modules/homebridge"
      },
      "noFork": {
        "title": "Do not run the Config UI web server in a separate process/thread",
        "type": "boolean",
        "description": "If you are running Homebridge in a container, you may need to enable this option."
      },
      "host": {
        "title": "Host IP Address",
        "type": "string",
        "pattern": "^[^{}/ :\\\\]+(?::\\d+)?$",
        "description": "The host ip address to listen on. In most cases this will be '::' or '0.0.0.0'",
        "placeholder": "eg. 0.0.0.0"
      },
      "debug": {
        "title": " Enable / disable debug level logging",
        "type": "boolean",
        "description": "If enabled, the Homebridge UI will log debug level messages to the console."
      },
      "standalone": {
        "title": "Tell Homebridge the plugin is operating in standalone mode",
        "type": "boolean",
        "description": "If you are running Homebridge in a container, you may need to enable this option."
      },
      "sessionTimeout": {
        "title": "Session Timeout (in seconds)",
        "type": "integer",
        "placeholder": 28800,
        "minimum": 600,
        "maximum": 86400000,
        "description": "The number of seconds before a user session will timeout. Defaults to 8 hours."
      },
      "log": {
        "type": "object",
        "title": "Log Settings",
        "description": "The log settings for the Homebridge UI.",
        "properties": {
          "method": {
            "title": "Log Method",
            "type": "string",
            "default": "",
            "description": "The method used to read the Homebridge log file.",
            "required": true,
            "oneOf": [
              {
                "title": "Default",
                "enum": [
                  ""
                ]
              },
              {
                "title": "From File",
                "enum": [
                  "file"
                ]
              },
              {
                "title": "Systemd",
                "enum": [
                  "systemd"
                ]
              },
              {
                "title": "Custom Command",
                "enum": [
                  "custom"
                ]
              }
            ]
          },
          "path": {
            "title": "Log File Path",
            "type": "string",
            "description": "Enter the full file path to your log file.",
            "placeholder": "/var/log/homebridge.log",
            "required": true,
            "condition": {
              "functionBody": "return (model.log && model.log.method==='file')"
            }
          },
          "service": {
            "title": "Systemd Service",
            "type": "string",
            "description": "Enter the systemd service name. Defaults to 'homebridge'.",
            "placeholder": "homebridge",
            "required": true,
            "condition": {
              "functionBody": "return (model.log && model.log.method==='systemd')"
            }
          },
          "command": {
            "title": "Custom Command",
            "description": "This command should stream the logs to stdout.",
            "type": "string",
            "placeholder": "journalctl -f -n 100 -u homebridge",
            "required": true,
            "condition": {
              "functionBody": "return (model.log && model.log.method==='custom')"
            }
          },
          "tail": {
            "type": "string",
            "description": "Depreciated",
            "condition": {
              "functionBody": "return (model.log && (model.log.method==='custom' || model.log.method==='systemd' || model.log.method==='file'))"
            }
          },
          "systemd": {
            "type": "string",
            "description": "Depreciated",
            "condition": {
              "functionBody": "return (model.log && (model.log.method==='custom' || model.log.method==='systemd' || model.log.method==='file'))"
            }
          }
        }
      },
      "ssl": {
        "title": "SSL Setup",
        "type": "object",
        "description": "The SSL settings for the Homebridge UI.",
        "properties": {
          "key": {
            "title": "Path To Private Key",
            "type": "string",
            "description": "The full path to the private key file.",
            "placeholder": "eg. /Users/homebridge/.homebridge/certs/server.key"
          },
          "cert": {
            "title": "Path To Certificate",
            "type": "string",
            "description": "The full path to the certificate file.",
            "placeholder": "eg. /Users/homebridge/.homebridge/certs/server.crt"
          },
          "pfx": {
            "title": "Path To PKCS#12 Certificate",
            "type": "string",
            "description": "The full path to the PKCS#12 certificate file.",
            "placeholder": "eg. /Users/homebridge/.homebridge/certs/server.pfx"
          },
          "passphrase": {
            "title": "PKCS#12 Certificate Passphrase",
            "type": "string",
            "description": "The passphrase for the PKCS#12 certificate file.",
            "placeholder": "eg. mypassphrase"
          }
        }
      },
      "accessoryControl": {
        "title": "Accessory Control Setup",
        "type": "object",
        "description": "The accessory control settings for the Homebridge UI.",
        "properties": {
          "debug": {
            "title": " Enable / disable debug level logging for accessory control via the web UI",
            "type": "boolean",
            "description": "If enabled, the Homebridge UI will log debug level messages to the console."
          },
          "instanceBlacklist": {
            "title": "Blacklisted Instances",
            "type": "array",
            "description": "A list of instances that should not be controlled via the web UI.",
            "placeholder": "eg. 00:00:00:00:00:00",
            "items": {
              "title": "Instance Username",
              "type": "string",
              "pattern": "^([A-Fa-f0-9]{2}:){5}[A-Fa-f0-9]{2}$"
            }
          }
        }
      },
      "linux": {
        "title": "Linux Server Commands",
        "type": "object",
        "description": "The Linux server commands for the Homebridge UI.",
        "properties": {
          "shutdown": {
            "title": "Shutdown Command",
            "type": "string",
            "placeholder": "eg. shutdown",
            "description": "If no shutdown command is set the process will terminate with a non-zero exit code."
          },
          "restart": {
            "title": "Restart Command",
            "type": "string",
            "placeholder": "eg. reboot",
            "description": "If no restart command is set the process will terminate with a non-zero exit code."
          }
        }
      },
      "proxyHost": {
        "title": "Reverse Proxy Hostname",
        "type": "string",
        "pattern": "^[^{}/ :\\\\]+(?::\\d+)?$",
        "placeholder": "eg. example.com:8443",
        "description": "When running behind a reverse proxy you may need to enter the hostname you use to access the UI."
      },
      "scheduledBackupPath": {
        "title": "Scheduled backup destination path",
        "description": "The full path to where the service should save daily scheduled backups archives",
        "type": "string",
        "placeholder": "eg. /home/pi/homebridge-backups"
      },
      "scheduledBackupDisable": {
        "title": "Disable Scheduled Backups",
        "type": "boolean",
        "description": "When enabled, the Homebridge UI will not create daily scheduled backups"
      },
      "disableServerMetricsMonitoring": {
        "title": "Disable Server Metrics Monitoring",
        "type": "boolean",
        "description": "When enabled, the Homebridge UI will not collect or report cpu / memory stats"
      }
    }
  },
  "layout": [
    {
      "type": "flex",
      "flex-flow": "row wrap",
      "items": [
        {
          "type": "flex",
          "flex-flow": "column",
          "items": [
            "theme",
            "lang"
          ]
        },
        {
          "type": "flex",
          "flex-flow": "column",
          "items": [
            "port",
            "tempUnits"
          ]
        }
      ]
    },
    {
      "ref": "advanced",
      "type": "fieldset",
      "expandable": true,
      "title": "Advanced",
      "items": [
        {
          "ref": "login",
          "type": "fieldset",
          "expandable": true,
          "title": "Login Settings",
          "items": [
            "auth",
            {
              "key": "sessionTimeout",
              "type": "number"
            },
            {
              "type": "help",
              "helpvalue": "<label class='control-label'>Custom Login Wallpaper</label><br><p class='help-block'>Custom login wallpaper can be set by adding a 'ui-wallpaper.jpg' file to your Homebridge storage directory, or by providing the full path to the .jpg file below:</p>"
            },
            {
              "key": "loginWallpaper",
              "notitle": true
            }
          ]
        },
        {
          "ref": "log",
          "type": "fieldset",
          "expandable": true,
          "title": "Log Settings",
          "items": [
            "debug",
            "log.method",
            "log.path",
            "log.service",
            "log.command",
            "log.tail",
            "log.systemd"
          ]
        },
        {
          "ref": "accessoryControl",
          "type": "fieldset",
          "expandable": true,
          "title": "Accessory Control",
          "items": [
            "accessoryControl.debug",
            {
              "key": "accessoryControl.instanceBlacklist",
              "type": "array",
              "items": {
                "key": "accessoryControl.instanceBlacklist[]",
                "type": "string",
                "pattern": "^([A-Fa-f0-9]{2}:){5}[A-Fa-f0-9]{2}$",
                "title": "Instance Username"
              }
            }
          ]
        },
        {
          "ref": "hostname",
          "type": "fieldset",
          "expandable": true,
          "title": "Hostname Settings",
          "items": [
            "proxyHost",
            "host"
          ]
        },
        {
          "ref": "ssl",
          "type": "fieldset",
          "expandable": true,
          "title": "SSL Settings",
          "items": [
            "ssl.key",
            "ssl.cert",
            "ssl.pfx",
            "ssl.passphrase"
          ]
        },
        {
          "ref": "homebridge",
          "type": "fieldset",
          "expandable": true,
          "title": "Homebridge Settings",
          "items": [
            "sudo",
            "restart",
            "homebridgePackagePath"
          ]
        },
        {
          "ref": "operatingSystem",
          "type": "fieldset",
          "expandable": true,
          "title": "Operating System Specific Settings",
          "items": [
            "disableServerMetricsMonitoring",
            {
              "ref": "linux",
              "type": "fieldset",
              "expandable": true,
              "title": "Linux Settings",
              "items": [
                "linux.shutdown",
                "linux.restart",
                "temp"
              ]
            },
            {
              "ref": "container",
              "type": "fieldset",
              "expandable": true,
              "title": "Container Settings",
              "items": [
                "standalone",
                "noFork"
              ]
            }
          ]
        },
        {
          "ref": "scheduledBackup",
          "type": "fieldset",
          "expandable": true,
          "title": "Scheduled Backup Settings",
          "items": [
            "scheduledBackupDisable",
            "scheduledBackupPath"
          ]
        }
      ]
    }
  ]
}