HASS Configurator - Home Assitant Core - Ubuntu 20.04 - Tutorial

I wanted to post this to help others out, this was how I installed HASS Configurator on Home Assistant Core with Ubuntu 20.04. I ended up installing this in my HASS venv (python3.8) to keep things together, I am not sure if this is the best way to do this but it does not seem to have any issues. Any suggestions are welcome.

sudo su -s /bin/bash homeassistant
source /srv/homeassistant/bin/activate
pip3 install hass-configurator
exit
sudo vi /etc/systemd/system/[email protected]

Add this to the file:

[Unit]
Description=HASS-Configurator
After=network-online.target

[Service]
Type=simple
User=homeassistant
# Some security related options.
# See https://www.freedesktop.org/software/systemd/man/systemd.exec.html for details.
# NoNewPrivileges=true
# ProtectSystem=true
InaccessiblePaths=-/mnt -/media
ReadOnlyPaths=/bin -/lib -/lib64 -/sbin
# PrivateTmp=true
# ProtectKernelTunables=true
# ProtectKernelModules=true
# ProtectControlGroups=true
# RestrictRealtime=true

# Set configuration options by specifying environment variables
# Environment=HC_LISTENIP=0.0.0.0
# Environment=HC_PORT=3218
# Environment=HC_GIT=false
# Environment=HC_ALLOWED_NETWORKS=192.168.1.0/24,127.0.0.1
# ...
# Set the path to your configurator.py location

WorkingDirectory=/home/homeassistant/.homeassistant
ExecStart=/srv/homeassistant/bin/python3 /srv/homeassistant/lib/python3.8/site-packages/hass_configurator/configurator.py settings.conf -s
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl --system daemon-reload
sudo systemctl enable [email protected]
sudo systemctl start [email protected]

sudo vi /home/homeassistant/.homeassistant/configuration.yaml

Add this, x.x.x.x should be your hass IP or domain name:

panel_iframe:
  configurator:
    title: Configurator
    icon: mdi:wrench
    url: http://x.x.x.x:3218

Restart HA, and you should be all set.

Note: If you are using https on your frontend, keep in mind that you cannot load a http iframe. Personally I solve this issue using haproxy on my pfsense firewall.

1 Like