Skip to main content
porter auth contains commands for authenticating with Porter.

porter auth login

Authenticate with your Porter account. By default, this opens your browser to complete authentication. Usage:
porter auth login [flags]
Options:
FlagDescription
--tokenLog in using an existing token
porter auth login
After logging in, Porter automatically sets your default project and cluster if you have access to any. You can view these with porter config.

Credential storage

The location where credentials are persisted depends on the login method configured via porter config set-login-method:
  • v1 (default): A long-lived Porter JWT is written to porter.yaml.
  • v2: Access and refresh tokens are stored in your OS credential store (macOS Keychain, Linux Secret Service, or Windows Credential Manager) and refreshed automatically. Switching to v2 and logging in migrates any existing plaintext tokens out of porter.yaml.

porter auth logout

Log out from Porter and clear your local credentials. Usage:
porter auth logout
After logging out, you’ll need to run porter auth login again before using other commands.