License

Activate, deactivate, and inspect your LocalCan license from the terminal. LocalCan also runs without a license in free mode (.local only).

Free mode vs activated

LocalCan starts without a key. Free mode serves .local domains over the HTTP/HTTPS proxy with full traffic inspection. Activating a license unlocks Public URLs and localcan tcp.

To try out all features, sign up for a 14-day trial on the LocalCan dashboard↗. No credit card required.

First-run consent

The first time you run LocalCan, it asks you to accept the Terms of Service↗. Review the Terms↗ and Privacy Policy↗, then answer y. Acceptance is recorded and you are not asked again until the Terms change.

Free mode never asks about usage data, it stays off until you opt in.

On a headless host or in a script (no terminal on stdin) the command exits with an error instead of prompting. Accept the Terms ahead of time:

localcan accept-terms

You can also pass --accept-terms to any engine command to accept non-interactively:

localcan start --accept-terms

Activate

localcan license activate localcan_xxxxxxxxxxxxx

The first activation runs an interactive flow: you'll be asked to accept the Terms of Service and to opt in or out of anonymous usage data. To skip both prompts, for CI, headless servers, or scripts, pass the answers as flags:

localcan license activate localcan_xxxxxxxxxxxxx \
  --accept-terms \
  --no-usage-data

If the key is already activated on a different machine and you want to move it, add --reassign:

localcan license activate localcan_xxxxxxxxxxxxx --accept-terms --reassign

When --json is set, all prompts are suppressed and --accept-terms becomes mandatory.

Deactivate

localcan license deactivate

Frees the seat so you can activate the key on another machine. The daemon keeps running and drops to free mode, so .local and the HTTP/HTTPS proxy keep serving. Only Public URLs and TCP tunnels pause until a new key is activated. Run localcan stop if you want the daemon down too.

Usage data

Telemetry is opt-in and off by default. Turn anonymous usage data on or off at any time, in free mode or when activated:

localcan license set-usage-data yes
localcan license set-usage-data no

Status

localcan license status

Reports the current mode (free or licensed), the masked key, device ID and name, platform, CLI and desktop versions, and your update window:

Mode                   licensed
License key            localcan_xxxxxxxxxxxx****
Device ID              c5b1...
Device name            my-laptop
Platform               darwin/arm64
CLI version            3.0.0-beta.4
Terms accepted         2026-05-20
Desktop version        3.0.0-beta.4
Updates allowed until  Jan 1, 2027
Updates expired        no

If Updates expired is yes, the line below tells you how many CLI releases you're behind and points to the dashboard to renew. Your existing license keeps working, only access to newer releases is gated.

Pass --json to consume the same data as a structured object.