Configuration

CLI Configuration

Configuration Directory

All CLI configuration is stored in:

Platform	Location
macOS/Linux	`~/.flightstack/`
Windows	`%USERPROFILE%\.flightstack\`

Files

cli_config.json

User authentication and API settings:

{
  "apiUrl": "https://api.flightstack.voostack.com",
  "accessToken": "eyJhbG...",
  "refreshToken": "eyJhbG...",
  "tokenExpiresAt": "2024-01-15T10:30:00Z",
  "userId": "abc123...",
  "email": "you@example.com"
}

Created by flightstack login, removed by flightstack logout.

config.json (Agent)

Agent registration configuration:

{
  "agentId": "a1b2c3d4-...",
  "token": "eyJhbG...",
  "apiUrl": "https://api.flightstack.voostack.com",
  "agentName": "My-MacBook-Pro",
  "platform": "macOS",
  "organizationId": null,
  "organizationName": null
}

Created by flightstack-agent register.

Profile Support

Both CLI and agent support multiple configuration profiles for different environments:

Using Profiles

# CLI with profile
flightstack login --profile dev  # Creates cli_config.dev.json
flightstack status --profile dev

# Agent with profile
flightstack-agent register --profile dev  # Creates config.dev.json
flightstack-agent start --profile dev

Environment Variable

Set the FLIGHTSTACK_PROFILE environment variable to use a profile by default:

export FLIGHTSTACK_PROFILE=dev

# These now use dev profile automatically
flightstack status
flightstack-agent start

Profile Files

Profile	CLI Config	Agent Config
(none)	`cli_config.json`	`config.json`
`dev`	`cli_config.dev.json`	`config.dev.json`
`staging`	`cli_config.staging.json`	`config.staging.json`

agent.log

Agent runtime logs (when running):

[14:32:15] FlightStack Build Agent
[14:32:15] ✓ Agent is online
[14:35:22] New build job received
...

agent.pid

Process ID when agent is running in daemon mode.

Environment Variables

Variable	Description
`FLIGHTSTACK_API_URL`	Override API URL
`FLIGHTSTACK_TOKEN`	Override auth token
`FLIGHTSTACK_PROFILE`	Set config profile (e.g., `dev`, `staging`)

Custom API URL

For self-hosted FlightStack:

# Set via environment
export FLIGHTSTACK_API_URL=https://flightstack.mycompany.com

# Or edit config.json manually

Resetting Configuration

Remove all CLI data:

rm -rf ~/.flightstack

Then run flightstack login to reconfigure.