Skip to content

docs: add service account and personal access token pages - #56

Open
Kaysahni wants to merge 2 commits into
mainfrom
kanishk/sat-docs
Open

docs: add service account and personal access token pages#56
Kaysahni wants to merge 2 commits into
mainfrom
kanishk/sat-docs

Conversation

@Kaysahni

@Kaysahni Kaysahni commented Aug 1, 2026

Copy link
Copy Markdown
Collaborator

Documents the two non-interactive ways to authenticate with FloxHub, both new in Flox CLI 1.14.0.

New pages

concepts/service-accounts (Team/Enterprise) — an identity that belongs to the organization rather than to a person, for CI and other automation. Covers the two access levels, creating an account, issuing and revoking tokens, using one in CI, and rotating without downtime.

concepts/personal-access-tokens (all plans) — signs the CLI in as you, for SSH sessions, containers, and other machines without a browser. Covers creating, using via --token-file or FLOX_FLOXHUB_TOKEN, and revoking.

Existing pages

  • tutorials/ci-cd: new "Authenticating with FloxHub" section — when a pipeline actually needs credentials, and giving it its own identity instead of a person's
  • concepts/floxhub: points at both pages from the authentication section
  • concepts/organizations: a Service accounts section above the existing machine access tokens
  • docs.json: both pages added to the Concepts nav

🤖 Generated with Claude Code

https://claude.ai/code/session_01L9FR5u25zs4iMXnS4V7uwm

Document the two non-interactive ways to authenticate with FloxHub in
Flox CLI 1.14.0: service accounts (org-owned, for CI) and personal
access tokens (user-owned, for headless machines).

- concepts/service-accounts: access levels, creating, issuing tokens,
  using in CI, revoking, and rotating without downtime
- concepts/personal-access-tokens: creating, using via --token-file or
  FLOX_FLOXHUB_TOKEN, viewing and revoking
- tutorials/ci-cd: new section on when a pipeline needs credentials and
  how to give it its own identity
- concepts/floxhub, concepts/organizations: point at the new pages
- docs.json: add both to the Concepts nav

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L9FR5u25zs4iMXnS4V7uwm
@mintlify

mintlify Bot commented Aug 1, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
flox 🟢 Ready View Preview Aug 1, 2026, 9:57 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L9FR5u25zs4iMXnS4V7uwm
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.

1 participant