Binary Install #

Homechart can be deployed as a standalone binary on Linux (amd64 and arm) from our releases website.

1. Review the requirements #

Ensure your system meets the Server Requirements.

2. Download Homechart #

Visit https://releases.homechart.app/ and download the version of Homechart for your platform. Optionally, you can verify your download by comparing the SHA-512 sum:

$ sha256sum -c homechart_latest_linux_amd64.gz.sha256

Once your download has completed, decompress it:

$ gzip -d homechart_latest_linux_arm.gz
$ mv /usr/local/bin/homechart
$ chmod +x /usr/local/bin/homechart

3. Run Homechart #

The Homechart executable can be ran from any directory and stores no files locally. You will need to provide some configuration settings via environment variables or a JSON configuration file, see Configuration Options.

CLI #

A minimal command line for Homechart with a config file in the current directory:

$ homechart -c config.yaml serve

systemd #

A base homechart.service file with a config file in /usr/local/etc:

[Unit]
Description=Homechart - Your Handy Home Assistant
Documentation=https://docs.homechart.app
After=network.target

[Service]
Type=simple
User=homechart
Group=homechart
ExecStart=/usr/local/bin/homechart -c /usr/local/etc/homechart.yaml run
Restart=always
RestartSec=1s

[Install]
WantedBy=multi-user.target

We do something similar to this method for running Homechart in the cloud.