Skip to content
FlightStack Docs

Authentication

Authentication

Section titled “Authentication”

Login

Section titled “Login”

Authenticate with FlightStack:

Terminal window
flightstack login

This opens your default browser for authentication. After completing login in the browser, you’ll see:

✓ Logged in successfully!


Welcome back, your-username

How It Works

Section titled “How It Works”
  1. CLI generates a secure authentication request
  2. Browser opens to FlightStack login page
  3. You authenticate (email/password or OAuth)
  4. Token is securely stored locally

Token Storage

Section titled “Token Storage”

Credentials are stored at ~/.flightstack/config.json:

{
  "apiUrl": "https://api.flightstack.dev",
  "accessToken": "eyJhbG...",
  "refreshToken": "eyJhbG..."
}

Tokens are automatically refreshed when expired.

Logout

Section titled “Logout”

Sign out and remove stored credentials:

Terminal window
flightstack logout
✓ Logged out successfully

Checking Login Status

Section titled “Checking Login Status”

Many commands require authentication. If not logged in:

Not logged in. Run: flightstack login

Troubleshooting

Section titled “Troubleshooting”

Browser Doesn’t Open

Section titled “Browser Doesn’t Open”

Manually visit the URL shown in the terminal and complete authentication.

Token Expired

Section titled “Token Expired”

Re-run flightstack login to refresh your session.

Multiple Accounts

Section titled “Multiple Accounts”

The CLI supports one account at a time. Log out and log in with a different account as needed.