Skip to main content
Version: 2.3

Install via Loft CLI

Using Loft CLI is the preferred way to deploy Loft to a Kubernetes cluster. If you decide later on you want to manage your Loft instance via GitOps, you may export the applied Kubernetes manifests or Helm chart configuration and store this data in a git repository.

1. Download CLI

Use one of the following commands to download the Loft CLI binary from GitHub:

curl -L -o loft "https://github.com/loft-sh/loft/releases/latest/download/loft-darwin-amd64" && sudo install -c -m 0755 loft /usr/local/bin

Alternatively, you can download the binary for your platform from the GitHub Releases page and add this binary to your PATH.

2. Deploy Loft

Make sure you are using the correct kube-context via kubectl config current-context and then run:

loft start

The CLI will ask for your email address to create the admin user and then deploy Loft via Helm to your cluster.

Troubleshooting

Your Loft pod is not starting or the UI is not showing up? View our Troubleshooting Guide if you have any issues.

3. Login

While loft start is running in the background, open a second terminal window and sign in via the CLI:

loft login https://localhost:9898  --insecure     # See `loft start` output for login credentials

This command will open the browser where you can sign in using the login data shown in the output of loft start.

Accept Untrusted Certificate

Since Loft generates a self-signed SSL certificate, you need to run loft login with the --insecure flag and once the browser opens, you will also need to accept the untrusted self-signed certificate before the login page will show up. Once you connect a domain to Loft later on, you can use your own, valid certificates or have one provisioned via cert-manager.