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

# config

> Manage CLI configuration

The `vlmrun config` command manages CLI configuration stored at `~/.vlmrun/config.toml`.

## Initialize

Create a default configuration file:

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
# Create config file
vlmrun config init

# Overwrite existing config
vlmrun config init --force
```

| Option    | Short | Description                    |
| --------- | ----- | ------------------------------ |
| `--force` | `-f`  | Overwrite existing config file |

## Show

Display the current configuration (API key is masked):

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
vlmrun config show
```

## Set

Set configuration values:

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
# Set API key
vlmrun config set --api-key "your-api-key"

# Set base URL
vlmrun config set --base-url "https://api.vlm.run/v1"
```

| Option       | Description          |
| ------------ | -------------------- |
| `--api-key`  | VLM Run API key      |
| `--base-url` | VLM Run API base URL |

## Unset

Remove configuration values:

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
# Remove API key
vlmrun config unset --api-key

# Remove base URL
vlmrun config unset --base-url
```

| Option       | Description        |
| ------------ | ------------------ |
| `--api-key`  | Unset the API key  |
| `--base-url` | Unset the base URL |

## Configuration Priority

Configuration values are resolved in the following order (highest priority first):

1. CLI flags (`--api-key`, `--base-url`)
2. Environment variables (`VLMRUN_API_KEY`, `VLMRUN_BASE_URL`)
3. Config file (`~/.vlmrun/config.toml`)