Skip to content

docs: document v2 login method and OS keyring credential storage#318

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/adfa3035
Open

docs: document v2 login method and OS keyring credential storage#318
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/adfa3035

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Jun 4, 2026

Summary

Documents the new v2 login flow that stores CLI credentials in the OS keyring (Keychain / Secret Service / Credential Manager) instead of as plaintext in porter.yaml.

Changes

  • standard/cli/command-reference/porter-config.mdx: added porter config set-login-method [v1|v2] reference with mode comparison, migration note, and CI/CD guidance.
  • standard/cli/command-reference/porter-auth.mdx: added a "Credential storage" subsection under porter auth login explaining where tokens are persisted under each login method.

Context

Triggered by porter-dev/code#5903 ("feat: add keyring"), which adds OS keyring–backed session storage for the v2 login flow and migrates legacy plaintext tokens out of porter.yaml on first v2 login.

cc @d-g-town for review.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Jun 4, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview Jun 4, 2026, 2:05 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants