Skip to main content
Use the license command to manage activation.

​
Subcommands

​
JSON Output

license subcommands support --json (long flag only). Each license <cmd> --json invocation emits a single JSON object (status, activation result, validation outcome, trial pendingId, etc.).

​
flowdeck license validate

Force an immediate server-side license validation, bypassing the once-per-day cache. Useful when:
  • You just renewed or extended your license.
  • You activated on another machine and want to confirm this machine still has a slot.
  • Cached state seems stale (e.g. status shows “activated” but features are locked).
Exits with code 0 when the license is valid, or 1 for invalid / network error / not activated.

​
flowdeck license trial

Two-step flow to activate a 14-day FlowDeck CLI trial. The license-manager emails you a 6-digit verification code; you confirm it with trial verify.

​
flowdeck license trial start

Request a verification code by name + email.
Constraints: one trial per email, one trial per machine. The code expires after a few minutes — capture the pendingId from the response, then call verify with the code from the email.

​
flowdeck license trial verify

Confirm the OTP and persist the trial license locally.
On success the trial license (TRIAL-… key) is stored just like an activated paid license. Check it with flowdeck license status.

​
flowdeck license purchase

Open the FlowDeck pricing page in your default browser. If the browser cannot be launched (headless / CI / piped output), the URL is printed so it can be copy-pasted. Prefer this over hardcoding the pricing URL in scripts or docs — the URL is owned by the CLI and updated centrally.
For CI/CD, set FLOWDECK_LICENSE_KEY in the environment and call flowdeck license activate "$FLOWDECK_LICENSE_KEY" at the start of the job instead of activating interactively.