docs: salvage Docker Hub image name fix from #3217 - #3260
Conversation
…ironclaw (#2963) Closes #2963. @magnusviri reported `pull access denied for nearai/ironclaw, repository does not exist` when following the install/docker.mdx guide. The Docker Hub repo is `nearaidev/ironclaw` (confirmed by both the publish workflow at .github/workflows/docker.yml — IMAGE_NAME: nearaidev/ironclaw — and the public Docker Hub page); `nearai/ironclaw` was never the correct image and is not under our control. Sweeps every Docker-Hub image reference in the docs to the correct name. README.md is intentionally untouched — its `nearai/ironclaw` references are gitcgr.com URLs to the source repository, not Docker Hub image pulls. Files updated: - docs/drafts/install/docker.mdx (5 occurrences) - docs/drafts/install/updating.mdx (2 occurrences) - docs/drafts/install/uninstalling.mdx (1 occurrence) - docs/drafts/platforms/docker-compose.mdx (1 occurrence) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Code Review
This pull request updates the Docker image repository from nearai/ironclaw to nearaidev/ironclaw across various documentation files. The review feedback identifies a critical syntax error in the docker run example where a comment breaks the multi-line command and suggests adding version-pinning guidance to the Docker Compose documentation for consistency with other guides.
| # Replace :latest with a specific version tag for reproducible, rollback-friendly deployments. | ||
| nearaidev/ironclaw:latest |
There was a problem hiding this comment.
The comment on line 34 breaks the multi-line docker run command because it lacks a trailing backslash. In most shells, this causes the command to terminate at the comment line, leaving the image name on line 35 to be executed as a separate (and invalid) command. Moving the comment to the end of the image name line fixes this while preserving the documentation guidance.
nearaidev/ironclaw:latest # Replace :latest with a specific version tag for reproducible, rollback-friendly deployments.
| services: | ||
| ironclaw: | ||
| image: nearai/ironclaw:latest | ||
| image: nearaidev/ironclaw:latest |
There was a problem hiding this comment.
For consistency with the main Docker installation guide and to promote best practices for production deployments, consider adding the guidance to replace :latest with a specific version tag here.
# Replace :latest with a specific version tag for reproducible, rollback-friendly deployments.
image: nearaidev/ironclaw:latest
* docs(docker): fix Docker Hub image name nearai/ironclaw -> nearaidev/ironclaw (nearai#2963) Closes nearai#2963. @magnusviri reported `pull access denied for nearai/ironclaw, repository does not exist` when following the install/docker.mdx guide. The Docker Hub repo is `nearaidev/ironclaw` (confirmed by both the publish workflow at .github/workflows/docker.yml — IMAGE_NAME: nearaidev/ironclaw — and the public Docker Hub page); `nearai/ironclaw` was never the correct image and is not under our control. Sweeps every Docker-Hub image reference in the docs to the correct name. README.md is intentionally untouched — its `nearai/ironclaw` references are gitcgr.com URLs to the source repository, not Docker Hub image pulls. Files updated: - docs/drafts/install/docker.mdx (5 occurrences) - docs/drafts/install/updating.mdx (2 occurrences) - docs/drafts/install/uninstalling.mdx (1 occurrence) - docs/drafts/platforms/docker-compose.mdx (1 occurrence) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(docker): clarify latest tag guidance --------- Co-authored-by: Abhishek Vaidyanathan <abhishekvaidyanathan@0a:c3:a6:ef:bb:28.home> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Salvage of #3217 onto current main.
Summary
Cherry-picked the Docker documentation fix from #3217 onto current
origin/main.This updates Docker Hub image references from
nearai/ironclawto the publishednearaidev/ironclawimage in the Docker install/update/uninstall/compose docs. The change remains relevant because the current publish workflows usenearaidev/ironclaw, and issue #2963 reports thatnearai/ironclaw:latestdoes not exist.A maintainer follow-up commit addresses the review comment on #3217 by changing the misleading “Pin to a specific IronClaw version” comments next to
:latestexamples to “Replace :latest with a specific version tag...” guidance.Original PR
docs/correct-dockerhub-image-nameCo-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>docs(docker): clarify latest tag guidance.Salvage review
origin/maindocs contain Docker image references tonearai/ironclaw:<tag>, while.github/workflows/docker.ymlpublishesnearaidev/ironclaw.origin/maindoes not already contain this Docker docs fix; no stalenearai/ironclaw:<tag>refs remain in docs after the salvage branch..github/workflows/docker.ymland.github/workflows/rebuild-release-image.yml, both of which usenearaidev/ironclaw.:latestexamples being adjacent to “Pin to a specific version” comments.Validation
git grep -n "nearai/ironclaw:" -- docs-> passed; no stale Docker image refs with a tag remain in docsgit diff --check origin/main...HEAD-> passeddocs/drafts/install/docker.mdx-> passed; old wording removedNotes