Configuration

With Plerion CLI configuration, you can manage credentials, profiles, regions, and output preferences. The CLI resolves settings from multiple sources in order of precedence (highest first):

CLI flags (--api-key, --region, --endpoint-url)
Environment variables (PLERION_API_KEY, PLERION_REGION, etc.)
Named profile from config files (selected via --profile or PLERION_PROFILE)
[default] profile from config files

Getting an API key

Go to the Plerion dashboard and sign in with your credentials.

Navigate to API Keys

Go to Settings > API Keys.

Create a key

Click Create API Key, give it a name, and copy the key. You will not be able to see it again.

Interactive setup

plerion configure

This prompts for your API key, region, output format, and profile name, then writes both config files.

plerion configure list

Lists all configured profile names.

Credentials file

Location: ~/.plerion/credentials

[default]
api_key = pk_live_xxxxxxxxxxxxxxxx

[prod]
api_key = pk_live_yyyyyyyyyyyyyyyyyy

[staging]
api_key = pk_live_zzzzzzzzzzzzzzzzzz

Config file

Location: ~/.plerion/config

[default]
region = au
output = table

[prod]
region = us1
output = json

[staging]
region = sg1
output = table

Both files use bare section names (e.g. [prod], not [profile prod]).

Environment variables

Variable	Description
`PLERION_API_KEY`	API key (overrides credentials file)
`PLERION_REGION`	Region (overrides config file)
`PLERION_PROFILE`	Profile name (default: `default`)
`PLERION_ENDPOINT_URL`	Custom API base URL (for development)
`NO_COLOR`	Set to any value to disable color output

Regions

Region	Code	Base URL
Australia	`au`	`https://au.api.plerion.com`
Singapore	`sg1`	`https://sg1.api.plerion.com`
India	`in1`	`https://in1.api.plerion.com`
United States	`us1`	`https://us1.api.plerion.com`

Multiple profiles

# Use a named profile for a single command
plerion --profile prod findings list --severity CRITICAL

# Set the default profile for the session
export PLERION_PROFILE=prod
plerion findings list

Getting started

Commands

Getting an API key

Interactive setup

Credentials file

Config file

Environment variables

Regions

Multiple profiles

​Getting an API key

​Interactive setup

​Credentials file

​Config file

​Environment variables

​Regions

​Multiple profiles

Getting an API key

Interactive setup

Credentials file

Config file

Environment variables

Regions

Multiple profiles