Skip to main content
porter config contains commands for managing local CLI configuration settings.

porter config

Display the current CLI configuration, including project, cluster, and authentication details. Usage:
porter config
Configuration values can be overridden using flags or environment variables. See Basic Usage for details.

porter config set-host

Saves the host in the default configuration. Usage:
porter config set-host [HOSTNAME]
porter config set-host https://dashboard.porter.run
The hostname must include the protocol (https://) and should not contain trailing slashes.

porter config set-project

Set the active project. This command shows a list of projects you have access to and lets you select one. Usage:
porter config set-project [PROJECT_ID]
porter config set-project

porter config set-cluster

Set the active cluster. This command shows a list of clusters in the current project and lets you select one. Usage:
porter config set-cluster [CLUSTER_ID]
porter config set-cluster
Run porter cluster list first to see available clusters and their IDs.

Configuration File

Porter stores configuration in ~/.porter/config.json. You can also override settings using environment variables:
VariableDescription
PORTER_PROJECTOverride project ID
PORTER_CLUSTEROverride cluster ID
PORTER_TOKENOverride authentication token
PORTER_HOSTOverride API host