Settings

Configure Coding Sandbox to match your workflow and preferences.

Accessing Settings

Open Settings by clicking the gear icon in the top-right corner of the Coding Sandbox window, or use the keyboard shortcut:

macOS — Cmd + ,
Windows / Linux — Ctrl + ,

General

Launch at startup — Automatically start Coding Sandbox when your computer boots.
Check for updates — Automatically check for new versions on launch.
Theme — Choose between Dark (default) and System theme.
Notifications — Enable or disable desktop notifications for sandbox events (started, stopped, tunnel connected).

Docker

Docker socket path — Path to the Docker socket. Auto-detected on most systems. Override if using a custom Docker installation.
Default resource limits — Set default CPU and memory limits for new sandboxes. Individual sandboxes can override these.
Image pull policy — Choose when to pull sandbox base images: always, if-not-present, or never.
Cleanup stopped containers — Automatically remove Docker containers when a sandbox is deleted.

Changes to Docker settings take effect for newly created sandboxes. Existing sandboxes keep their current configuration.

Local API

The local API allows you to control sandboxes programmatically from scripts, CI tools, or AI agents. See the Local API Reference for full documentation.

Enable API server — Toggle the local REST API on or off. Disabled by default.
Port — The port the API listens on (default: 8090).
Require authentication — When enabled, all API requests must include a Bearer token.
API key — Generate, view, and rotate your local API key.

Tunnels

Auto-enable tunnels — Automatically create a tunnel when a new sandbox starts.
Tunnel authentication — Require a token to access tunnel URLs. Enabled by default on Pro plans.
Default tunnel port — The container port to expose through the tunnel (default: 3000).

Snapshots

Storage location — Directory where snapshots are saved on disk.
Auto-snapshot on stop — Automatically create a snapshot before stopping a sandbox.
Max snapshots per sandbox — Limit the number of retained snapshots (Free plan: 3, Pro: unlimited).

Advanced

Verbose logging — Enable detailed logging for debugging issues.
Log file location — Path to the application log file.
Reset all settings — Restore all settings to their defaults.
Export/Import config — Export your configuration to a JSON file or import from one.

Reset

Resetting settings does not delete your sandboxes or snapshots — it only restores the application preferences to their defaults.

CLI Configuration

All settings can also be read and written via the csb config command:

bash

# View a setting
csb config get api.enabled

# Change a setting
csb config set api.port 9090

# List all settings
csb config list

# Reset to defaults
csb config reset

Config File Location

macOS — ~/Library/Application Support/CodingSandbox/config.json
Windows — %APPDATA%\CodingSandbox\config.json
Linux — ~/.config/coding-sandbox/config.json

Tunnel Access

Local API