Documentation Index
Fetch the complete documentation index at: https://porter-mintlify-7ddcac07.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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:
| Flag | Description |
|---|---|
--token | Log in using an existing token |
After logging in, Porter automatically sets your default project and cluster if you have access to any. You can view these with
porter config.porter auth workos-login
Authenticate with your Porter account using WorkOS. This opens your browser to complete authentication through WorkOS AuthKit using the OAuth 2.0 Authorization Code flow with PKCE.
Use this command if your organization has been configured to sign in to Porter via WorkOS (for example, with SSO). The standard porter auth login flow remains available for accounts that do not use WorkOS.
Usage:
- The CLI starts a local HTTP server on
localhost:8080to receive the OAuth callback. - Your default browser opens to the WorkOS AuthKit sign-in page.
- After you sign in, WorkOS redirects back to
http://localhost:8080/callback. - The CLI exchanges the authorization code for an access token using PKCE, stores it in your CLI config, and configures your default project.
Port
8080 on localhost must be available for the callback to succeed. If the port is in use, stop the conflicting process and try again.