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 Cmd+,.

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

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.

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

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.

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.

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/

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.

Next Steps

Keyboard Shortcuts

Learn every shortcut for faster debugging workflows

Traffic Capture

Set up HTTP and HTTPS traffic interception