Self hosted
Run Lunar Hub yourself on Kubernetes — the overview, prerequisites, install walkthrough, config sync, and day-2 operations, in the order you need them.
Last updated
Run Lunar Hub yourself on Kubernetes — the overview, prerequisites, install walkthrough, config sync, and day-2 operations, in the order you need them.
Self hosting means you run Lunar Hub on your own Kubernetes cluster and operate it: you provision its dependencies, run helm install, and own upgrades, secret rotation, and backups. If you would rather Earthly did all of that, see Lunar Dedicated instead.
Lunar Hub is supported on Kubernetes only. Bare-metal and Docker installations are not supported.
Overview — what a Hub deployment is made of: the Hub service, the operator, the transient snippet pods, and the external dependencies they need. Read this first if you want the shape of the system before committing to it.
Prerequisites — Postgres, S3 buckets, namespaces, DNS, a licence, and your Git platform credentials. Everything that must exist before helm install.
Install walkthrough — step by step from zero to a working Hub, including the values file and how to verify the install.
Sync Config — keep the Hub's copy of your configuration current on every push, from a GitHub Action or a GitLab CI job. Strongly recommended: without it you apply config changes by hand.
Day-2 operations — upgrades, secret rotation, observability, backup and restore, and uninstall.
Two neighboring sections apply to Dedicated installs as well, so they sit outside this one:
Git Platforms covers creating the credential the Hub authenticates with, on GitHub or GitLab. You need it by the prerequisites step.
Lunar CI Tracer covers build-time data, if you want it. The tracer installs on your CI runners rather than in the cluster, so it is independent of the Hub install and can be added later.
Last updated