> ## Documentation Index
> Fetch the complete documentation index at: https://rockxy-develop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Configure proxy port, recording behavior, buffer sizes, log capture, and excluded hosts

## Opening Settings

Open the settings panel from the menu bar: **Rockxy → Settings** or press <kbd>Cmd</kbd>+<kbd>,</kbd>.

<Frame caption="Rockxy Settings panel">
  <img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/rockxy-develop/images/settings.png" alt="Rockxy Settings panel" />

  <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/rockxy-develop/images/settings-dark.png" alt="Rockxy Settings panel (dark mode)" />
</Frame>

## General

| Setting          | Default | Description                                               |
| ---------------- | ------- | --------------------------------------------------------- |
| Auto-Start Proxy | Off     | Start the proxy server automatically when Rockxy launches |
| Record on Launch | On      | Begin recording network traffic immediately on startup    |

## Proxy

| Setting        | Default     | Description                                                                                       |
| -------------- | ----------- | ------------------------------------------------------------------------------------------------- |
| Proxy Port     | `9090`      | Local proxy server port. Change if another service occupies 9090                                  |
| Listen Address | `127.0.0.1` | Network interface to bind. Use `0.0.0.0` to accept connections from other devices on your network |
| Excluded Hosts | *(empty)*   | Comma-separated list of hosts to bypass the proxy entirely                                        |

<Tip>
  Add noisy hosts like `analytics.example.com` or `telemetry.sdk.io` to the excluded list to keep your session focused on the traffic you care about.
</Tip>

## Buffer Sizes

| Buffer             | Default | Description                                                           |
| ------------------ | ------- | --------------------------------------------------------------------- |
| Transaction Buffer | 50,000  | Maximum number of HTTP transactions held in the in-memory ring buffer |
| Log Buffer         | 100,000 | Maximum number of log entries held in the in-memory ring buffer       |

<Note>
  When either buffer reaches capacity, the oldest 10% of entries are evicted — moved to the SQLite database or discarded depending on your retention settings. This keeps memory usage stable during long debugging sessions.
</Note>

## Log Capture

Toggle log capture on or off from the **Log Capture** section in Settings. When enabled, Rockxy captures logs from:

* **OSLog** — system and application logs via `OSLogStore` (macOS 12+)
* **Process stdout/stderr** — output from monitored processes
* **Custom sources** — logs from installed plugins that conform to the log source protocol

Configure which sources are active and set minimum log level filters (Debug, Info, Warning, Error, Critical) per source.

## MCP

Rockxy includes a dedicated **Settings → MCP** tab for local MCP integration.

| Setting                                    | Default                                | Description                                                                                                  |
| ------------------------------------------ | -------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Enable MCP Server                          | Off                                    | Starts Rockxy's local MCP backend and allows the bundled `rockxy-mcp` bridge to connect                      |
| MCP Configuration                          | Generated from your installed app path | Copyable JSON snippet for Claude Desktop and other MCP clients                                               |
| Redact Sensitive Data Before Sending to AI | On                                     | Redacts sensitive headers, query values, and supported body fields before Rockxy returns data to MCP clients |

Important notes:

* Rockxy's MCP server is **local-only**
* the generated config uses the exact installed path to `rockxy-mcp`
* if you move `Rockxy.app`, copy the config again from this tab
* Claude CLI and Claude Desktop use separate MCP config stores
* Claude Desktop remote **Connectors** are not the right place for Rockxy's local MCP bridge

For the full setup walkthrough, see [MCP Integration](/features/mcp).

## Data Storage Locations

Rockxy stores data across several locations on disk:

| Data                | Location                                           |
| ------------------- | -------------------------------------------------- |
| User Preferences    | `~/Library/Preferences/com.amunx.Rockxy.plist`     |
| Root CA Key         | macOS Keychain (managed by `KeychainHelper`)       |
| Session Database    | `~/Library/Application Support/Rockxy/sessions.db` |
| Large Bodies (>1MB) | `~/Library/Application Support/Rockxy/bodies/`     |
| Rules               | `~/Library/Application Support/Rockxy/rules.json`  |
| Certificate Cache   | `~/Library/Application Support/Rockxy/certs/`      |

<Warning>
  The Root CA private key is stored in the macOS Keychain and protected by system-level access controls. Do not attempt to export or modify it manually — use Rockxy's certificate management UI instead.
</Warning>

## Next Steps

<CardGroup cols={2}>
  <Card title="Keyboard Shortcuts" icon="keyboard" href="/customization/keyboard-shortcuts">
    Learn every shortcut for faster debugging workflows
  </Card>

  <Card title="Traffic Capture" icon="globe" href="/features/traffic-capture">
    Set up HTTP and HTTPS traffic interception
  </Card>
</CardGroup>