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.

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