HASS Configurator

As long as a fully featured configuration GUI for Home Assistant is still under development, you can use this add-on to add a browser based file-editor to your Hass.IO installation. By default it will listen on port 3218 of the host Hass.IO is running on.

More information and a standalone version for regular Home Assistant installations can be found in the GitHub repository.

Screenshot of the HASS Configurator.

Feature list

  • Web-Based editor to modify your files with syntax highlighting.
  • Upload and download files.
  • Stage and commit changes in Git repositories, create and switch between branches, push to remotes.
  • Lists of available triggers, events, entities, conditions and services. Selected element gets inserted into the editor at the last cursor position.
  • Restart Home Assistant directly with the click of a button. Reloading groups, automations etc. can be done as well. An API-password is required.
  • SSL support.
  • Optional authentication and IP filtering for added security.
  • Direct links to Home Assistant documentation and icons.
  • Execute shell commands within the add-on container.
  • Editor settings are saved in your browser.

Add-on Configuration

  "username": "admin",
  "password": "secret",
  "certfile": "fullchain.pem",
  "keyfile": "privkey.pem",
  "ssl": false,
  "allowed_networks": [""],
  "banned_ips": [""],
  "banlimit": 0,
  "ignore_pattern": ["__pycache__"],
  "dirsfirst": false,
  • username (Optional): Set a username to access your configuration is protected.
  • password (Required): Set a password for access.
  • ssl (Optional): Enable or Disable SSL for the editor.
  • allowed_networks (Optional): Limit access to the configurator by adding allowed IP addresses / networks to the list.
  • banned_ips (Optional): List of statically banned IP addresses.
  • banlimit (Optional): Ban access from IPs after banlimit failed login attempts. The default value 0 disables this feature. Restart the add-on to clear the list of banned IP addresses.
  • ignore_pattern (Optional): Files and folders to ignore in the UI.
  • dirsfirst (Optional): List directories before files in the filebrowser.

Embedding into Home-Assistant

Using the Home Assistant component panel_iframe it is possible to embed the configurator directly into Home Assistant, allowing you to modify your configuration within the Home Assistant frontend.

An example configuration would look like this:

    title: Configurator
    icon: mdi:wrench
    url: http://hassio.local:3218

Be careful when setting up port forwarding to the configurator while embedding into Home Assistant. If you don’t restrict access by requiring authentication and / or blocking based on client IP addresses, your configuration will be exposed to the internet!