Skip to main content

​
Opening Settings

Open the settings panel from the menu bar: Rockxy → Settings or press Cmd+,.
Rockxy Settings panel

​
General

SettingDefaultDescription
Auto-Start ProxyOffStart the proxy server automatically when Rockxy launches
Record on LaunchOnBegin recording network traffic immediately on startup

​
Proxy

SettingDefaultDescription
Proxy Port9090Local proxy server port. Change if another service occupies 9090
Listen Address127.0.0.1Network 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

BufferDefaultDescription
Transaction Buffer50,000Maximum number of HTTP transactions held in the in-memory ring buffer
Log Buffer100,000Maximum 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:
DataLocation
User Preferences~/Library/Preferences/com.amunx.Rockxy.plist
Root CA KeymacOS 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