Skip to content
Branch: master
Find file Copy path
Find file Copy path
2 contributors

Users who have contributed to this file

@andrey-git @jumblies
54 lines (39 sloc) 2.29 KB

Installing CustomUI

Hosted use (HA 0.53+)

Instead of installing CustomUI files on you Home Assistant machine you can have your browser fetch them directly from GitHub servers. In this case you don't need to download any files.


  • Easier to set up.
  • You can choose to either use the 'latest' release or a specific release.
  • You automatically get bug-fixes if you use 'latest'.


  • Requires Internet connection.
  • The hoster of the files (GitHub) can track how often you open Home Assistant.
  • You automatically get breaking changes if you use 'latest'.

Local install

Automatic install.

  1. Download to your homeassistant config dir. (For example /home/homeassistant/.homeassistant/) You can do so by running
curl -o ""

from that dir.

  1. Make executable by running
$ chmod u+x
  1. Run it:
$ ./

The script updates itself and downloads CustomUI main code into www/custom_ui and Customizer component into custom_components. The script will prompt you about creating any of those dirs if they don't exist.



$ ./

again. It will update everything telling you which files changed.

Manual install

Place state-card-custom-ui.html and state-card-custom-ui.html.gz in ~/.homeassistant/www/custom_ui/ dir to install the main code.

Additionally on HA 0.59 and later place state-card-custom-ui-es5.html and state-card-custom-ui-es5.html.gz in ~/.homeassistant/www/custom_ui/ dir to install the es5 version.

(HA 0.52 and earlier only) Place ha-panel-custom-ui.html and ha-panel-custom-ui.html.gz in ~/.homeassistant/panels/ dir to install CustomUI configuration panel.

Place all files from into ~/.homeassistant/custom_components/customizer

You can’t perform that action at this time.