Backups
Setup Homechart backups
Self-Hosting Homechart is easy:
The server component of Homechart is written in Go and has very low resource requirements:
Homechart can be self-hosted using containers or binaries (or a mix of both):
Homechart requires full access to a PostgreSQL 14 database. Older or newer versions may work, but they are not tested. Homechart can share an existing PostgreSQL server, just create a new database for it.
Install PostgreSQL using your distribution’s package manager or from source. Instructions can be found on PostgreSQL’s website.
Run the PostgreSQL container.
Create a database for Homechart on a PostgreSQL server with these commands, replacing the database name, username and password if necessary:
CREATE DATABASE homechart;
CREATE ROLE "homechart" WITH CREATEDB LOGIN PASSWORD 'homechart';
REVOKE ALL PRIVILEGES ON SCHEMA public FROM public;
GRANT ALL PRIVILEGES ON DATABASE homechart TO "homechart";
GRANT ALL PRIVILEGES ON SCHEMA public TO "homechart";
Homechart is distributed as a single Go binary or a container. Both are effectively the same app, just packaged differently.
Homechart binaries are available on GitHub.
curl -L https://github.com/candiddev/homechart/releases/latest/download/homechart_linux_amd64.tar.gz -O
curl -L https://github.com/candiddev/homechart/releases/latest/download/homechart_linux_amd64.tar.gz.sha256 -O
sha256sum -c homechart_linux_amd64.tar.gz.sha256
tar -C /usr/local/bin -xzf homechart_linux_amd64.tar.gz
curl -L https://github.com/candiddev/homechart/releases/latest/download/homechart_linux_arm.tar.gz -O
curl -L https://github.com/candiddev/homechart/releases/latest/download/homechart_linux_arm.tar.gz.sha256 -O
sha256sum -c homechart_linux_arm.tar.gz.sha256
tar -C /usr/local/bin -xzf homechart_linux_arm.tar.gz
curl -L https://github.com/candiddev/homechart/releases/latest/download/homechart_linux_arm64.tar.gz -O
curl -L https://github.com/candiddev/homechart/releases/latest/download/homechart_linux_arm64.tar.gz.sha256 -O
sha256sum -c homechart_linux_arm64.tar.gz.sha256
tar -C /usr/local/bin -xzf homechart_linux_arm64.tar.gz
Homechart containers are available on GitHub. See the platform specific Installation Guides for usage.
Homechart can be configured using a configuration file, environment variables, or command line arguments. See the Config Reference for details.
Using households in Homechart requires a subscription, even for self-hosted users. You can subscribe monthly or buy a lifetime subscription/one time purchase, too.
You’ll need to link your self-hosted instance household to a household on Homechart Cloud to use your subscription. No data is transferred to Homechart Cloud, it’s just used to transfer the subscription details.
docker run -e HOMECHART_POSTGRESQL_HOSTNAME=homechart -e HOMECHART_POSTGRESQL_PASSWORD=homechart -e HOMECHART_POSTGRESQL_USERNAME=homechart -p 3000:3000 -d ghcr.io/candiddev/homechart:latest
docker-compose.yml
file:version: "3"
services:
homechart:
depends_on:
- postgres
environment:
HOMECHART_POSTGRESQL_HOSTNAME: postgres
HOMECHART_POSTGRESQL_PASSWORD: postgres
HOMECHART_POSTGRESQL_USERNAME: postgres
image: ghcr.io/candiddev/homechart:latest
ports:
- "3000:3000"
restart: always
postgres:
environment:
POSTGRES_PASSWORD: postgres
image: docker.io/postgres:14
restart: always
volumes:
- postgres:/var/lib/postgresql/data
volumes:
postgres: {}
docker-compose up -d
helm repo add homechart https://helm.homechart.app/
helm install my-homechart homechart/homechart
podman run -e HOMECHART_POSTGRESQL_HOSTNAME=homechart -e HOMECHART_POSTGRESQL_PASSWORD=homechart -e HOMECHART_POSTGRESQL_USERNAME=homechart -p 3000:3000 -d ghcr.io/candiddev/homechart:latest