Docs Blog Apps Pricing

Getting Started

1. Install the CLI 2. Login 3. Build and Push 4. Boot on GCP 5. Boot on Bare Metal

Guides

Authentication Pushing and Pulling Images Configuring Images Working with Hosts Working with GCP Working with Bare Metal latitude.sh OVHcloud Working with AWS Backups Tips and Tricks

CLI Reference

kheeper auth kheeper authorizations kheeper bots kheeper clouds kheeper contexts kheeper hosts kheeper images kheeper orgs kheeper push kheeper releases kheeper status

Bare Metal: latitude.sh

latitude.sh offers on-demand bare metal servers with hourly billing and a Custom iPXE option in the order form, which makes it the quickest way to bring up a Kheeper host on real hardware. This page covers the provider-specific steps; see Working with Bare Metal for the general flow and Boot on Bare Metal for an end-to-end tutorial.

Step 1 — Create an iPXE script

Generate a one-time iPXE script for the host name you want. The script is valid for 24 hours and is consumed the first time a machine registers with it.

kheeper hosts ipxe create myorg/web-server

This prints a multi-line script that starts with #!ipxe and ends with boot. Copy the whole thing.

Step 2 — Order the server with Custom iPXE

  1. Log in at latitude.sh
  2. Click Create Server
  3. Pick a server and location
  4. Under Operating System, select Custom iPXE and paste the script from step 1
  5. Under Billing, select Hourly if you only want to try it out
  6. Click Deploy

latitude.sh server configuration

latitude.sh boots the server straight into your script — there is nothing else to configure on their side, and no finish hook or callback to worry about.

Step 3 — Wait and verify

The install takes ten to thirty minutes. When it finishes, the machine reboots into the Kheeper base image and auto-registers under the name you chose:

kheeper hosts list --org myorg

You should see web-server in the list. From here, deploy to it like any other host — see Working with Hosts.