// OPEN SOURCE · SELF-HOST

Run HomeHub on your own machine.

The whole HomeHub codebase is MIT licensed. If you'd rather not let our servers touch your household's data, you don't have to. One command gets you a working instance on a Mac mini, a Linux box, or a spare laptop.

What you'll need

A machine running Linux or macOS, Docker, and about 2GB of RAM. That's it. No Kubernetes, no Postgres cluster — a single container with an embedded database.

The one command

curl -sSL https://get.homehub.app | sh

It pulls the latest image, writes a homehub.env next to it, and prints the URL to open in your browser.

Connecting your integrations

Calendar, bank, and grocery integrations need API keys from their respective providers. Self-hosted instances use your own keys — we walk through each one in the repo's docs/integrations/ folder.

Updating

homehub upgrade pulls the latest image, runs any migrations, and restarts the container. We cut a release about every two weeks. Breaking changes come with a heads-up in the changelog.

Backups

The container writes to ~/.homehub/data/. Back that directory up however you already back things up (Time Machine, restic, rsync to a NAS). That's the whole backup story.

Getting help

Open a discussion on github.com/homehub, or email help@homehub.app. We help self-hosters too — not just paying customers.