Skip to content

docs: document containerRegistryAuthId for private Flash images - #816

Draft
justinwlin wants to merge 1 commit into
mainfrom
docs/800-container-registry-auth-id
Draft

docs: document containerRegistryAuthId for private Flash images#816
justinwlin wants to merge 1 commit into
mainfrom
docs/800-container-registry-auth-id

Conversation

@justinwlin

Copy link
Copy Markdown
Collaborator

The Flash custom Docker images page told readers to configure Docker registry authentication in Runpod console for private images but never explained how a Flash endpoint references the saved credential — without the field, private image pulls fail with no actionable hint. This adds the missing mechanism: pass the credential ID via PodTemplate(containerRegistryAuthId=...), with instructions for obtaining the ID (runpodctl registry list or the Container Registry Authentication section of console settings).

Fixes #800

Internal: CON-1233

What changed

  • flash/custom-docker-images.mdx: new "Private images" section showing PodTemplate(containerDiskInGb, containerRegistryAuthId), a warning about missing credentials, and how to obtain the ID (runpodctl registry list, runpodctl registry create, console settings → Container Registry Authentication, GHCR read:packages note). Troubleshooting "Authentication errors" bullet now points to the new section.
  • flash/configuration/parameters.mdx: added containerRegistryAuthId to the PodTemplate reference table and example, with a pointer to the new section.

How verified

  • Field name and semantics cross-checked against the SDK source at runpod_flash/core/resources/template.py (containerRegistryAuthId: Optional[str], serialized into the build manifest in cli/commands/build_utils/manifest.py).
  • node scripts/validate-tooltips.js passes; mintlify broken-links reports only pre-existing CLAUDE.md links.
  • Internal link /runpodctl/reference/runpodctl-registry and anchor #private-images (from the ## Private images heading) checked.

@mintlify

mintlify Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
runpod-docs 🟢 Ready View Preview Aug 25, 2026, 2:40 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.

PodTemplate.containerRegistryAuthId is required for private images and is documented nowhere

1 participant