Skip to content

docs: private image credentials (docker-registry secrets) - #767

Draft
warp-factories[bot] wants to merge 1 commit into
mainfrom
missing-docs/docker-registry-secrets
Draft

warp-factories[bot] wants to merge 1 commit into
mainfrom
missing-docs/docker-registry-secrets

Conversation

@warp-factories

@warp-factories warp-factories Bot commented Sep 18, 2026 •

Copy link
Copy Markdown
Contributor

What this feature does

oz secret create docker-registry (and the web Private image credential type) stores a registry host, username, and password so Warp-hosted Linux runners and environments can pull private sandbox images. The credential authenticates the pull only — it is never injected as an environment variable. Shipped in v0.2026.09.16.08.27.stable_02 (2026-09-16).

Summary

Drift-watch for stable v0.2026.09.16.08.27.stable_02. #15913 was deferred on 2026-09-11 (not yet in stable); Gate 0 now clears. Updates existing secrets, runners, and factory-as-code pages.

Content design plan

  • Reader and job: A platform engineer configuring a Linux runner or environment that boots from a private GHCR/ECR/company image, who needs to store pull credentials Warp can use at sandbox start.
  • Gap today: factory-as-code already names linux.registryCredentialSecretName / docker_registry, but secrets and runners pages never said how to create the credential or that it is not env-injected.
  • Change: Web + CLI create flows on platform/secrets.mdx, a private-image paragraph on platform/runners.mdx, and a create link from factories/factory-as-code.mdx. Excludes attaching via oz runner create (no CLI flag yet) and ECR-specific auth types not in this release's CLI surface.

Changes

src/content/docs/platform/secrets.mdx

  • Web app: Raw value vs Private image credential create flows
  • CLI: oz secret create docker-registry flags (--host, --username, --password-file, --password)
  • Note that private image credentials are pull-only (not env-injected)

src/content/docs/platform/runners.mdx

  • Linux tab: private image + secret attach pointer

src/content/docs/factories/factory-as-code.mdx

  • Link registryCredentialSecretName to the new secrets section

Unverified claims

  • Exact runner/environment web UI control labels for attaching registryCredentialSecretName were not verified against a live build (GraphQL field and factory-as-code key confirmed in code).
  • Display string Container Registry Credential from CLI list path confirmed in app/src/ai/agent_sdk/secret.rs; web list label not re-checked live.

Deferred findings (this release)

See companion bookkeeping PR. API routes mapped internal; other changelog items failed gates or were already covered.

Reviewer routing

suggest_reviewers.py resolved multiple humans (bnavetta, ianhodge, Legoben, captainsafia, liliwilson) — no single owner. Requesting dannyneira per drift-watch fallback so the PR is not left without a requested reviewer.

Documentation risk

Risk: engineering-review-required
Rationale: New CLI and UI docs for private image credentials; engineering should confirm host matching, non-injection, and attach surfaces.
Docs override: none

Add create flow for oz secret create docker-registry and the web UI
Private image credential type, plus runner/factory-as-code cross-links.
@vercel

vercel Bot commented Sep 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 18, 2026 4:11pm UTC

Request Review

@cla-bot cla-bot Bot added the cla-signed label Sep 18, 2026
@warp-factories
warp-factories Bot requested a review from dannyneira September 18, 2026 16:08
@warp-factories warp-factories Bot added the warpy-factory Opened by the Warp factory agents label Sep 18, 2026
@warp-factories

Copy link
Copy Markdown
Contributor Author

This PR was generated with Warp.

Comment @warp-agent on this PR to send it follow-up work.

This branch was successfully deployed

1 active deployment
Preview — 6ba5c96b Deployed Sep 18, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed warpy-factory Opened by the Warp factory agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants