fix(docs): point GHCR image pulls at the headroomlabs-ai org path#2473
Open
lacraig2 wants to merge 1 commit into
Open
fix(docs): point GHCR image pulls at the headroomlabs-ai org path#2473lacraig2 wants to merge 1 commit into
lacraig2 wants to merge 1 commit into
Conversation
The repo moved from the personal `chopratejas` account to the `headroomlabs-ai` org. GitHub redirects `github.com` and `raw.githubusercontent.com` URLs after a transfer, but GHCR does NOT redirect the old package — `ghcr.io/chopratejas/headroom` is frozen at v0.27.0 (2026-06-22), while every release since v0.28.0 publishes to `ghcr.io/headroomlabs-ai/headroom` (verified: :latest = v0.32.0). Anyone following the README / docs today pulls a ~5-versions-stale image. Update the user-facing docs (README, docs mdx, wiki, llms.txt, docker-compose, testing guide) to the live path. Left intentionally unchanged: - headroom/install/state.py + tests/test_install/* — the deprecated `chopratejas` string is the match target for the runtime migration added in headroomlabs-ai#2426. - github.com / raw.githubusercontent.com URLs — these redirect and still resolve, so they are not broken. - CHANGELOG.md — generated by release-please.
lacraig2
requested review from
DevanshiVyas,
JerrettDavis and
chopratejas
as code owners
July 21, 2026 19:31
Contributor
PR governanceThis PR does not yet satisfy the required template fields:
Please update the PR body, or move the PR back to draft while it is still in progress. |
JerrettDavis
approved these changes
Jul 21, 2026
JerrettDavis
left a comment
Collaborator
There was a problem hiding this comment.
Thanks, this is scoped and correct. I verified the patch only updates user-facing Docker/GHCR examples to ghcr.io/headroomlabs-ai/headroom and leaves the deprecated ghcr.io/chopratejas/headroom references in the install migration/test coverage where they are still intentional sentinel values. git diff --check HEAD^..HEAD is clean, and the PR checks are green.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
After the repo moved from the personal
chopratejasaccount to theheadroomlabs-aiorg, the docs still tell users to pullghcr.io/chopratejas/headroom. GitHub redirectsgithub.comandraw.githubusercontent.comURLs after a transfer, but GHCR does not redirect the old package — so that path is frozen at the last release before the move (v0.27.0, built 2026-06-22), while every release since v0.28.0 publishes toghcr.io/headroomlabs-ai/headroom(:latestis currently v0.32.0).Anyone following the README / install docs today therefore pulls an image ~5 minor versions stale. CI itself is healthy — the fix is purely documentation repointing at the live registry path.
Type of Change
Changes Made
ghcr.io/chopratejas/headroom→ghcr.io/headroomlabs-ai/headroomimage references in user-facing docs:README.md,docs/content/docs/installation.mdx,docs/content/docs/docker-install.mdx,wiki/cli.md,wiki/docker-install.md,llms.txt,docker-compose.yml, andTESTING-copilot-subscription.md(14 lines across 8 files).headroom/install/state.pyandtests/test_install/*: the deprecatedchopratejasstring there is the match target for the runtime manifest migration added in Persistent Docker deployments silently pin to dead chopratejas repo; no version-drift detection #2426, not a stale reference.github.com/raw.githubusercontent.comURLs: these redirect after the transfer and still resolve (verified below), so they are not broken.CHANGELOG.md— it is generated by release-please from the Conventional Commit title.Testing
pytest) — N/A, docs-only change, no code paths modifiedruff check .) — N/A, no Python changedmypy headroom) — N/A, no Python changedTest Output
Real Behavior Proof
ghcr.io/v2/...manifest API; upstreammainat the time of writing.curlthe manifest endpoint for both registry paths (see Test Output); additionally fetched the:latestimage config blob on each path and readorg.opencontainers.image.version.chopratejas—:latest= v0.27.0 (frozen 2026-06-22), version tags0.28.0–0.32.0all 404. New pathheadroomlabs-ai—:latest= v0.32.0 (promoted 2026-07-17),0.28.0–0.32.0all present.github.com/chopratejas/headroomreturns 301 →headroomlabs-ai, andraw.githubusercontent.com/chopratejas/.../install.shstill serves 200, confirming those URLs are not broken and were correctly left untouched.docker pullof each variant image (registry manifest resolution is sufficient to prove the tag exists); no application/unit tests run since no code changed.Review Readiness
Checklist
CHANGELOG.md— it is generated by release-please from my Conventional Commit PR title (a CI guard enforces this)Screenshots (if applicable)
N/A — text/registry-path change only.
Additional Notes
github.com/raw.githubusercontent.com/chopratejasURLs is deliberately out of scope here to keep this PR to the confirmed-broken references only.