Skip to content

docs: salvage Docker Hub image name fix from #3217 - #3260

Merged
serrrfirat merged 2 commits into
mainfrom
salvage/pr-3217-docker-docs
May 5, 2026
Merged

serrrfirat merged 2 commits into
mainfrom
salvage/pr-3217-docker-docs

Conversation

@serrrfirat

Copy link
Copy Markdown
Collaborator

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/ironclaw to the published nearaidev/ironclaw image in the Docker install/update/uninstall/compose docs. The change remains relevant because the current publish workflows use nearaidev/ironclaw, and issue #2963 reports that nearai/ironclaw:latest does 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 :latest examples to “Replace :latest with a specific version tag...” guidance.

Original PR

  • Original PR: docs(docker): fix Docker Hub image name to nearaidev/ironclaw (#2963) #3217
  • Original PR author: @abbyshekit
  • Original head branch: docs/correct-dockerhub-image-name
  • Original commit(s):
  • Original commit author: Abhishek Vaidyanathan <abhishekvaidyanathan@0a:c3:a6:ef:bb:28.home>
  • Original co-author trailer: Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
  • Attribution: original author, original commit SHA, and co-author trailer recorded; squash merge planned by default.
  • Authorship preservation mode: squash-attributed. This branch also includes one maintainer-authored follow-up commit: docs(docker): clarify latest tag guidance.

Salvage review

  • Relevance: still relevant because current origin/main docs contain Docker image references to nearai/ironclaw:<tag>, while .github/workflows/docker.yml publishes nearaidev/ironclaw.
  • Supersession check: current origin/main does not already contain this Docker docs fix; no stale nearai/ironclaw:<tag> refs remain in docs after the salvage branch.
  • Source-of-truth check: compared against .github/workflows/docker.yml and .github/workflows/rebuild-release-image.yml, both of which use nearaidev/ironclaw.
  • Review check: addressed the bot review comment about :latest examples being adjacent to “Pin to a specific version” comments.
  • Risk track: Track A, docs-only.

Validation

  • git grep -n "nearai/ironclaw:" -- docs -> passed; no stale Docker image refs with a tag remain in docs
  • git diff --check origin/main...HEAD -> passed
  • Changed-doc patch check for newly introduced markdown links -> passed; no new markdown links introduced
  • Review-comment check for old “Pin to a specific IronClaw version” wording in docs/drafts/install/docker.mdx -> passed; old wording removed

Notes

  • No source-code changes.
  • Recommended merge method: squash merge by default, preserving attribution in the PR/squash text.

Abhishek Vaidyanathan and others added 2 commits May 5, 2026 22:46
…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>
@github-actions github-actions Bot added size: S 10-49 changed lines risk: low Changes to docs, tests, or low-risk modules scope: docs Documentation contributor: core 20+ merged PRs and removed risk: low Changes to docs, tests, or low-risk modules labels May 5, 2026
@serrrfirat
serrrfirat merged commit e67945e into main May 5, 2026
30 checks passed
@serrrfirat
serrrfirat deleted the salvage/pr-3217-docker-docs branch May 5, 2026 20:51

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment on lines +34 to +35
# Replace :latest with a specific version tag for reproducible, rollback-friendly deployments.
nearaidev/ironclaw:latest

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

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

theredspoon pushed a commit to theredspoon/ironclaw that referenced this pull request Jun 21, 2026
* 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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contributor: core 20+ merged PRs scope: docs Documentation size: S 10-49 changed lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant