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.

Keep Projects Running on Quit

When enabled, quitting the app leaves your dev server projects running in the background (managed by the daemon). Disabled by default — quitting stops everything.

Keep Infrastructure Running on Quit

When enabled, quitting the app leaves DNS and proxy services running. Disabled by default.

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.

Default Package Manager

Select the preferred package manager for corral pm (and the cpm shim). This is used when no lockfile is detected in the project directory. Options: npm, yarn, pnpm, bun. When not set, defaults to npm.

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.

Log Display

These preferences control how logs appear in the log viewer. They are persisted in the settings file and shared across sessions.

Font Size

The monospaced font size used in the log viewer. Adjustable with Cmd+Plus (increase), Cmd+Minus (decrease), and Cmd+0 (reset to default). Default: 11.

Word Wrap

When enabled, long log lines wrap to the next line (indented to the message column). When disabled, the log view scrolls horizontally. Toggle from the More options menu (ellipsis icon) in the log toolbar. Default: on.

Preferred Browser

Choose which browser opens when you click project URLs in Corral (localhost links, .test domains, menu bar, and project commands). Defaults to your system default browser.

The picker automatically discovers all installed browsers on your Mac and displays them with their app icon. If the selected browser is later uninstalled, Corral falls back to the system default.

This setting only applies to local development URLs. Git repository links (e.g., "Open on GitHub") always open in the system default browser.

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

License

The License section manages your Corral Pro subscription.

When no license is active, a text field and Activate button are shown. Paste your license key (received after purchasing from corral.sh/pro) and click Activate to unlock Pro features immediately.

When a license is active, the section shows:

• Status — Active (green), Expired (red), Inactive (yellow), or Validation Failed (orange, when offline grace has expired)
• Product — the product name (Corral Pro)
• Customer — name and email from the purchase
• Devices — activation count vs. limit (e.g., 1/1)
• Expires — subscription expiry date
• Deactivate License — removes the license from this device, freeing the slot for another machine

If your license expires, Pro features become unavailable but all your data, projects, and configuration are preserved. Renewing re-activates everything.

About

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