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 16 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 for various architectures and operating systems:
Homechart containers are available on GitHub. See the platform specific Installation Guides for usage.
Homechart ships with a Software Bill of Materials (SBOM) manifest generated using CycloneDX. The .bom.json
manifest is available with the other Binary Assets.
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 purchase a lifetime subscription.
You’ll need to link your self-hosted 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:16
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