Install Lunar

Overview of Lunar installation, covering Hub, CLI, CI Agent for self-hosted and managed runners, and AI skills for building plugins.

Welcome to the Lunar installation guide.

This section contains step-by-step instructions for installing Lunar. Install these pieces, in this order:

1. Lunar CLI – an admin and development CLI. Install this first: the Hub install walkthrough uses lunar licence to derive your GHCR image-pull secret from your licence JWT before helm install.

   • Install the Lunar CLI

2. Lunar Hub – the central coordination service.

   • Overview – the lay of the land: services, dependencies, ports.

   • Prerequisites – what to have in place before helm install.

   • Install walkthrough – step-by-step from zero to a working Hub.

   • Day-2 operations – upgrades, secret rotation, observability, uninstall.

3. Lunar CI Agent — instruments your CI runners to report data to the Hub. Choose based on how your CI is set up:

   • Self-hosted runners

   • GitHub-hosted managed runners (the earthly/lunar-ci-action).

Optional:

• sync-config GitHub Action – pushes your config repo to Lunar Hub on every push.

• AI Skills – agent skills for building collectors and policies.

Want to try Lunar without installing anything? Get in touch for a guided demo or preview.

Request a demo

Before diving in, browse the 100+ pre-built guardrails and 30+ integrations available out of the box.