> ## Documentation Index
> Fetch the complete documentation index at: https://01c595a-spikonado.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://01c595a-spikonado.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://01c595a-spikonado.manicule.dev/docs/api/mcp.
> Every agent surface: https://01c595a-spikonado.manicule.dev/docs/.well-known/llms-manifest.json

# Configuration (/docs/reference/configuration)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 671 · updated: 2026-11-12 -->
Related: [CLI](/docs/reference/cli.md), [Keyboard shortcuts](/docs/reference/keyboard-shortcuts.md), [Settings](/docs/reference/settings.md)

> Environment variables, the ~/.sprocket data directory, ports, and credential storage for the Sprocket server, CLI, and desktop app.

## Environment variables

| Variable                      | Effect                                                                                           | Default                          |
| ----------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------- |
| `SPROCKET_PORT`               | Port for the local server. The desktop app reads it too.                                         | `17731`                          |
| `SPROCKET_HOST`               | Address the server listens on.                                                                   | `127.0.0.1`                      |
| `SPROCKET_DATA_DIR`           | Data directory. The desktop app reads it too.                                                    | `~/.sprocket`                    |
| `SPROCKET_DESKTOP_EXECUTABLE` | Path to the desktop app that `sprocket` opens.                                                   | The path in `desktop-executable` |
| `RUST_LOG`                    | Log filter, such as `info` or `sprocket_host=debug`. `sprocket_server` logs stay at errors only. | Errors only                      |

## Data directory

Sprocket keeps its local state in `~/.sprocket` on every OS. On Windows without `HOME` set, it uses `%USERPROFILE%\.sprocket`.

Each data directory is a separate profile with its own sign-in. Set `SPROCKET_DATA_DIR` to run a second profile.

| Path                 | Contents                                                 |
| -------------------- | -------------------------------------------------------- |
| `credentials/`       | Your sign-in, when stored in a file                      |
| `transcripts/`       | Cached thread transcripts, attachments, and command logs |
| `tools/`             | Tools Sprocket installs for the agent                    |
| `connectors/`        | Installed connectors, such as KiCad                      |
| `desktop-executable` | Where the desktop app is, saved each time it starts      |
| `cli-server.log`     | Log of the temporary server the CLI starts               |

## Credentials

Sprocket stores your sign-in in the OS keyring when one is available. Otherwise it falls back to an unencrypted file in the data directory that only your user can read, and `sprocket login` tells you so.

To choose the store yourself:

```sh
sprocket logout
sprocket login --credential-store keyring
```

Use `--credential-store file` to always use the file. Choosing one store clears the other.