"git add
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/certificates/tls_domain_certificate/index.html b/docs/ecosystem/certificates/tls_domain_certificate/index.html
index a5f9a506d2..fc65bb3dd9 100644
--- a/docs/ecosystem/certificates/tls_domain_certificate/index.html
+++ b/docs/ecosystem/certificates/tls_domain_certificate/index.html
@@ -319,6 +319,7 @@ Press Enter to Continue
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/certificates/tls_self_signed_certificate/index.html b/docs/ecosystem/certificates/tls_self_signed_certificate/index.html
index 7c78366cd3..0206e1e844 100644
--- a/docs/ecosystem/certificates/tls_self_signed_certificate/index.html
+++ b/docs/ecosystem/certificates/tls_self_signed_certificate/index.html
@@ -283,6 +283,7 @@
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hadashboard/dash_config/index.html b/docs/ecosystem/hadashboard/dash_config/index.html
index 18b59bad34..74b369225e 100644
--- a/docs/ecosystem/hadashboard/dash_config/index.html
+++ b/docs/ecosystem/hadashboard/dash_config/index.html
@@ -464,6 +464,7 @@
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hadashboard/hapush/index.html b/docs/ecosystem/hadashboard/hapush/index.html
index 02da21ef28..2fc03351c1 100644
--- a/docs/ecosystem/hadashboard/hapush/index.html
+++ b/docs/ecosystem/hadashboard/hapush/index.html
@@ -334,6 +334,7 @@ logfile = "/etc/hapush/hapush.log"
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hadashboard/index.html b/docs/ecosystem/hadashboard/index.html
index 53b305fcab..57591f08bc 100644
--- a/docs/ecosystem/hadashboard/index.html
+++ b/docs/ecosystem/hadashboard/index.html
@@ -274,6 +274,7 @@
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hadashboard/installation/index.html b/docs/ecosystem/hadashboard/installation/index.html
index b7abe920b1..5760c47ed8 100644
--- a/docs/ecosystem/hadashboard/installation/index.html
+++ b/docs/ecosystem/hadashboard/installation/index.html
@@ -362,6 +362,7 @@
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hadashboard/reboot/index.html b/docs/ecosystem/hadashboard/reboot/index.html
index 6a691b66a9..6032c2676e 100644
--- a/docs/ecosystem/hadashboard/reboot/index.html
+++ b/docs/ecosystem/hadashboard/reboot/index.html
@@ -271,6 +271,7 @@
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hadashboard/updating/index.html b/docs/ecosystem/hadashboard/updating/index.html
index 0d04c8ebf1..bb5df9bd78 100644
--- a/docs/ecosystem/hadashboard/updating/index.html
+++ b/docs/ecosystem/hadashboard/updating/index.html
@@ -277,6 +277,7 @@
scenegen
Synology
Backup to GitHub
+ HASS Configurator
diff --git a/docs/ecosystem/hass-configurator/index.html b/docs/ecosystem/hass-configurator/index.html
index b056e92313..acd5d4e59d 100644
--- a/docs/ecosystem/hass-configurator/index.html
+++ b/docs/ecosystem/hass-configurator/index.html
@@ -79,7 +79,8 @@ Essentially this is a browser-based alternative to modifying your configuration
Check valid configuration and restart Home Assistant directly with the click of a button
SSL support
Optional authentication and IP filtering for additional security
- Direct links to Home Assistant documentation
+ Direct links to Home Assistant documentation and icons
+ Execute shell commands
Runs on pretty much any machine Home Assistant can run on
@@ -88,7 +89,7 @@ Consider running the configurator as a user with limited privileges to limit pos
Installation (Linux, OS X)
There are no dependencies on Python modules that are not part of the standard library. And all the fancy JavaScript libraries are loaded from CDN (which means this doesn’t work when you’re offline).
- - Copy configurator.py to your Home Assistant configuration directory (e.g /home/homeassistant/.homeassistant)
+ - Copy configurator.py to your Home Assistant configuration directory (e.g /home/homeassistant/.homeassistant)
- Make it executable:
sudo chmod 755 configurator.py
- (Optional) Set the
GIT
variable in configurator.py to True
if GitPython is installed on your system. This is required if you want to make use of the Git integration.
- Execute it:
sudo ./configurator.py
@@ -96,7 +97,7 @@ Consider running the configurator as a user with limited privileges to limit pos
Configuration
Near the top of the configurator.py-file you will find some global variables you can change to customize the configurator. If you are unfamiliar with Python: when setting variables of the type string, you have to write that within quotation marks. The default settings are fine for just checking out the configurator quickly. With more customized setups you should change some settings though.
-To keep your settings across updates it is also possible to save settings in an external file. In that case copy settings.conf whereever you like and append the full path to the file to the command when starting the configurator. E.g. sudo .configurator.py /home/homeassistant/.homeassistant/mysettings.conf
. This file is in JSON format. So make sure it has a valid syntax (you can set the editor to JSON to get syntax highlighting for the settings). The major difference to the settings in the py-file is, that None
becomes null
.
+To keep your settings across updates it is also possible to save settings in an external file. In that case copy settings.conf whereever you like and append the full path to the file to the command when starting the configurator. E.g. sudo .configurator.py /home/homeassistant/.homeassistant/mysettings.conf
. This file is in JSON format. So make sure it has a valid syntax (you can set the editor to JSON to get syntax highlighting for the settings). The major difference to the settings in the py-file is, that None
becomes null
.
LISTENIP (string)
The IP the service is listening on. By default it is binding to 0.0.0.0
, which is every interface on the system.
LISTENPORT (integer)
@@ -159,14 +160,14 @@ Be careful when setting up port forwarding to the configurator while embedding i
- Fork the process into the background with the command:
nohup sudo ./configurator.py &
- - If your system is using systemd (that’s usually what you’ll find on a Raspberry PI), there’s a template file you can use and then apply the same process to integrate it as mentioned in the Home Assistant documentation. If you use this method you have to set the
BASEPATH
variable according to your environment.
- - If you have supervisor running on your system, hass-poc-configurator.supervisor would be an example configuration you could use to control the configurator.
+ - If your system is using systemd (that’s usually what you’ll find on a Raspberry PI), there’s a template file you can use and then apply the same process to integrate it as mentioned in the Home Assistant documentation. If you use this method you have to set the
BASEPATH
variable according to your environment.
+ - If you have supervisor running on your system, hass-poc-configurator.supervisor would be an example configuration you could use to control the configurator.
- A tool called tmux, which should be pre-installed with HASSbian.
- A tool called screen (alternative to tmux). If it’s not already installed on your system, you can do
sudo apt-get install screen
or sudo yum install screen
to get it. When it’s installed, start a screen session by executing screen
. Then navigate to your Home Assistant directory and start the configurator like described above. Put the screen session into the background by pressing CTRL+A
and then CTRL+D
. It is now safe to disconnect from your SSH session.
To resume the screen session, log in to your machine and execute screen -r
.
Troubleshooting, Issues etc.
-If you encounter difficulties setting up the configurator or stumble upon a possible bug, head over to the Issues section of the configurator repository. Additionally there is a thread at the Home Assistant Community where common problems may have been discussed already. And if not, there are always friendly people around to help finding solutions.
+If you encounter difficulties setting up the configurator or stumble upon a possible bug, head over to the Issues section of the configurator repository. Additionally there is a thread at the Home Assistant Community where common problems may have been discussed already. And if not, there are always friendly people around to help finding solutions.