---
title: Configuration
description: Customize devv CLI behavior and settings.
---

# Configuration

devv stores its configuration at `~/.config/devv/config.json`.

## View config

```bash
devv config show
```

```json
{
  "apiKey": "dv_live_...abc1",
  "apiBase": "https://api.devv.tools",
  "pipelines": [...],
  "aliases": {...},
  "history": [...]
}
```

## Settings

### API base URL

For self-hosted instances:

```bash
devv config set apiBase https://my-devv-instance.com
```

### Reset

```bash
devv config reset
```

## Config file structure

```json
{
  "apiKey": "dv_live_...",
  "apiBase": "https://api.devv.tools",
  "pipelines": [
    {
      "name": "format-and-encode",
      "spec": "json-formatter | base64-encode",
      "description": "Format JSON then base64 encode"
    }
  ],
  "aliases": {
    "jf": "json format",
    "h256": "hash - sha256"
  },
  "history": [
    "json format {\"a\":1}",
    "uuid",
    "hash hello sha256"
  ]
}
```

## Data locations

| Data | Path |
|------|------|
| Config | `~/.config/devv/config.json` |
| History | Stored within config |
| Pipelines | Stored within config |
| Aliases | Stored within config |

All data is local to your machine. Nothing is synced to the cloud.