> ## Documentation Index
> Fetch the complete documentation index at: https://kmerhosting.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# KmerHosting CLI guide

> Install, authenticate, and use the official KmerHosting terminal client.

KmerHosting CLI is published separately from the SDK but lives in the same monorepo.

## Install

```bash theme={null}
npm install --global @kmerhosting/cli
kh --help
```

## Configure the key

Linux or macOS:

```bash theme={null}
export KMERHOSTING_API_KEY="kh_live_REDACTED"
```

PowerShell:

```powershell theme={null}
$env:KMERHOSTING_API_KEY="kh_live_REDACTED"
```

<Frame caption="The CLI should be tested with a restricted test key and read-only commands first.">
  <img src="https://mintcdn.com/kmerhosting-a736a8a9/qmzUGdL1AajWuhXn/images/screenshots/cli-terminal.png?fit=max&auto=format&n=qmzUGdL1AajWuhXn&q=85&s=ac1a5769951a87afaa35948c8ec4671a" alt="The CLI should be tested with a restricted test key and read-only commands first." width="1600" height="900" data-path="images/screenshots/cli-terminal.png" />
</Frame>

## Read-only checks

```bash theme={null}
kh account
kh services
kh domains
kh invoices
kh orders
kh notifications --unread
```

## Auto-renewal

```bash theme={null}
kh auto-renew vps SERVICE_ID on
```

Confirm the service ID and account before running a state-changing command.