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

# Configuration

> Configure Claude Board via config.json and environment variables

Claude Board stores its configuration in a `config.json` file inside the application data directory. Settings can also be changed through the [setup wizard](/desktop/setup) on first launch or the in-app settings menu.

## Config File Location

| Platform | Default Path                                             |
| -------- | -------------------------------------------------------- |
| Windows  | `%APPDATA%/claude-board/config.json`                     |
| macOS    | `~/Library/Application Support/claude-board/config.json` |
| Linux    | `~/.config/claude-board/config.json`                     |

## Available Settings

| Setting   | Default     | Description                                        |
| --------- | ----------- | -------------------------------------------------- |
| `port`    | `4000`      | MCP HTTP server port for Claude runner integration |
| `dataDir` | OS-specific | Directory for database and uploads                 |

## MCP Server Port

The built-in MCP HTTP server allows Claude Code runners to communicate with Claude Board. Set the port in `config.json`:

```json theme={null}
{
  "port": 8080
}
```

<Note>If the port is in use, the MCP server will fail to start. Choose an available port or stop the conflicting process.</Note>

## Data Directory

Controls where Claude Board stores its SQLite database and uploaded file attachments:

```json theme={null}
{
  "dataDir": "/path/to/data"
}
```

Default locations by platform:

| Platform | Default Path                                  |
| -------- | --------------------------------------------- |
| Windows  | `%APPDATA%/claude-board/`                     |
| macOS    | `~/Library/Application Support/claude-board/` |
| Linux    | `~/.config/claude-board/`                     |

The directory contains:

* `claude-board.db` — SQLite database (all projects, tasks, settings)
* `uploads/` — file attachments
* `config.json` — application configuration

<Warning>Back up the data directory regularly. It contains all your project data, task history, and logs.</Warning>

## Environment Variables

For advanced use cases, the following environment variables are still respected and override `config.json` values:

| Variable            | Description                      |
| ------------------- | -------------------------------- |
| `CLAUDE_BOARD_DATA` | Override the data directory path |
| `PORT`              | Override the MCP server port     |