Settings

The Settings panel is accessible from the sidebar. It controls app-wide preferences, infrastructure, and system integration.

General

TLD

Choose the top-level domain for local routing:

• .test (recommended) — IANA-reserved for testing, no conflicts
• .localhost — also safe, supported on modern browsers
• Custom — enter any TLD you prefer

WARNING

Avoid .dev and .app (browsers enforce HSTS) and .local (conflicts with Bonjour/mDNS on macOS). See Domain Routing for details.

Auto-Start on Launch

When enabled, opening Corral (or running corral up) will automatically start infrastructure and all projects flagged with auto-start.

CLI

Shows whether the corral CLI is available on your PATH:

• Green checkmark — CLI is in PATH and ready to use
• "Not in PATH" — the symlink is missing; click "Add to PATH" to create it

Launch at Login

Toggle whether Corral starts automatically when you log in to macOS. Uses the system login items feature.

Default Node.js Version

Select the app-wide default Node.js version from installed versions. This is used when no project-specific version is configured. See Node.js Management for the full resolution chain.

Port Range Start

The first port in the allocation pool. Corral assigns ports sequentially from this number, with a pool of 100 ports. Default: 8787.

Infrastructure

DNS (dnsmasq)

Shows the current state of the DNS service:

• Status indicator — colored circle (green for running, gray for stopped, etc.)
• Start/Stop button — control the service independently

Proxy (Caddy)

Shows the current state of the reverse proxy:

• Status indicator and Start/Stop button — same as DNS above

Resolver

Displays the path to the macOS resolver file (/etc/resolver/{tld}) with:

• Checkmark if the file exists
• Warning if it's missing (infrastructure may not be started, or the helper may not be installed)

Background Service

The privileged helper daemon status:

State	Meaning
Green "Installed"	Helper is ready and operational
Yellow "Needs approval"	Helper was registered but the user hasn't approved it in System Settings
Gray "Not installed"	Helper hasn't been set up

Actions:

• Ping (when installed) — verifies the helper is reachable
• Install — registers the helper (triggers a system authorization prompt)
• Uninstall — removes the helper

About

• Wrangler version — the pinned version Corral ships with (currently 3.114.1)
• Data directory — path to the Corral data directory (~/.corral)