Configuration

Corral stores its settings in ~/.corral/config.json. You can view and change them from the CLI or the macOS app.

App Settings

Setting	Key	Default	Description
TLD	tld	test	Top-level domain for local routing
Auto-start	auto-start	false	Start infrastructure and flagged projects on launch
Default Node version	default-node-version	(none)	Fallback Node.js version when no project-specific version is set
Port range start	port-range-start	8787	First port in the allocation pool (100 ports)

Viewing Settings

corral settings show

Changing Settings

corral settings set tld localhost
corral settings set auto-start true
corral settings set default-node-version 22
corral settings set port-range-start 9000

Clear optional settings with none:

corral settings set default-node-version none

Boolean values accept: true/false, yes/no, 1/0, on/off.

In the macOS app, settings are available under the Settings panel in the sidebar. See macOS App Settings for details.

Data Directory

All Corral data lives in ~/.corral/:

Path	Contents
config.json	App-wide settings
projects.json	Registered projects and their settings
node/v{version}/	Installed Node.js versions
wrangler/v{version}/	Vendored Wrangler installations
caddy/	Caddy configuration files
dnsmasq/	dnsmasq configuration files
logs/	Persisted log files (per project)
bin/	Shell shims for node, npm, npx

Environment Variable

Override the data directory location:

export CORRAL_DATA_DIR=/path/to/custom/dir
corral status

Or pass it per command:

corral --data-dir /path/to/custom/dir status

This affects where Corral reads and writes all data — settings, projects, Node.js installations, logs, and infrastructure configuration.