First connection

1. Install Cloudflare WARP

Install warp-cli from Cloudflare and ensure the service runs:

warp-cli --version
warp-cli registration show

If unregistered:

warp-cli registration new

2. Install ThirdFlare One

./thirdflare-one install
thirdflare --version

3. Start the client

thirdflare

Or API-only:

thirdflare --no-open

4. Connect

From CLI:

thirdflare --connect

From API:

curl -X POST http://127.0.0.1:4173/api/action/connect

From UI: use the connect toggle in the native panel or Web UI.

5. Confirm

thirdflare --warp-status
curl -s http://127.0.0.1:4173/api/snapshot | jq '.status'

Operating mode

Expert mode exposes MASQUE vs WireGuard and split tunnel controls. Mode is normalized server-side — invalid values fall back safely.

See Configuration for layered config (system, user, env, session).