CLI Authentication | FlightStack

Authentication & session

Five top-level commands cover authentication and CLI session:

Command	Purpose
flightstack login	OAuth-flow login through your browser.
flightstack logout	Sign out and clear stored credentials.
flightstack config	View or change CLI config (API URL, auto-update).
flightstack doctor	Diagnose common CLI environment issues.
flightstack update	Update the CLI binary to the latest release.

flightstack login

Authenticate against FlightStack. Opens a browser tab, completes OAuth, writes credentials to ~/.flightstack/config.json.

flightstack login

Options

Flag	Alias	Description
--api-url <url>	-a	Override the API URL for this login (use for self-hosted).
--force	-f	Re-authenticate even if a valid session already exists.

Examples

# Cloud login
flightstack login

# Self-hosted login
flightstack login --api-url https://flightstack.acme.internal

# Force re-auth (rotate tokens)
flightstack login --force

After a successful login you’ll see:

✓ Logged in successfully!

Welcome back, you@example.com

Token storage

Credentials are stored at ~/.flightstack/config.json (on Windows: %USERPROFILE%\.flightstack\config.json). Tokens are refreshed automatically when they expire — no manual intervention required.

flightstack logout

Sign out and remove stored credentials.

flightstack logout

Interactive — confirms before clearing the local config. Use this when switching accounts or preparing a machine for transfer.

flightstack config

View and change CLI configuration. By default (no flags) prints the current configuration — API URL, auth state, token expiry, and auto-update setting.

flightstack config [--show] [--api-url <url>] [--auto-update true|false] [--reset]

Options

Flag	Alias	Description
--show	-s	Print the current configuration (default).
--api-url <url>		Set the API URL (must be http:// or https://).
--auto-update true|false		Enable or disable auto-update of the CLI.
--reset		Reset to defaults (clears credentials and API URL).

Examples

# Print current config
flightstack config

# Switch to self-hosted
flightstack config --api-url https://flightstack.acme.internal

# Disable auto-update
flightstack config --auto-update false

# Wipe everything
flightstack config --reset

Sample output of flightstack config:

FlightStack CLI Configuration
────────────────────────────────────────

API URL: https://api.flightstack.voostack.com
Config Path: ~/.flightstack/config.json
Auto-Update: Enabled

Authentication: Logged in
Account: you@example.com
User ID: 7d2a8c84-…
Token Expires: 2026-06-15T01:42:00Z

flightstack doctor

Diagnose common CLI environment issues — Flutter, Dart, Xcode, Android SDK, network reachability, config sanity. Run this first when something is misbehaving.

flightstack doctor

Distinct from flightstack agent doctor, which checks agent-side concerns (service installation, binary version, PID file). See agent commands.

flightstack update

Manually update the CLI binary to the latest release. Most installs auto-update — this is the escape hatch.

flightstack update

If auto-update is enabled, the CLI checks once per day and applies updates in the background. Disable with flightstack config --auto-update false.

Troubleshooting

Browser doesn’t open during login

The login flow prints the URL on the terminal — copy it into a browser manually.

Token expired

flightstack login --force issues fresh tokens. Most expirations refresh transparently on the next command.

Wrong API URL for self-hosted

flightstack config --api-url https://flightstack.acme.internal
flightstack login --force

Reset everything

flightstack config --reset
flightstack login