Skip to content

docs/usermanuals/en/operations/docker.md: false claim — "Pull the official image: docker pull ghcr.io/hodetech/forgelm:latest". Image variants latest (~12 GB, all extras), slim (~6 GB) and `airga… (DOC-D3B02-017) #217

Open

Description

@cemililik

Wave 1 · theme D1-10: Documentation-only fixes · highest severity High · 1 finding(s) · effort docs fix

Summary

Every quick-start command and the air-gap Dockerfile (FROM ghcr.io/...) fail.

Primary finding

DOC-D3B02-017 — docs/usermanuals/en/operations/docker.md: false claim — "Pull the official image: docker pull ghcr.io/hodetech/forgelm:latest". Image variants latest (~12 GB, all extras), slim (~6 GB) and `airga…

severity High · already tracked: KNOWN-OPEN C31-DOCKER-RUNBOOK docs/roadmap/phase-16-trust-surface-hardening.md:689-695; docs/roadmap/risks-and-decisions.md:200,260

Where. docs/usermanuals/en/operations/docker.md:8,12-34,46,98 (Turkish mirror: docs/usermanuals/tr/operations/docker.md:8,12-34,46,98) · type: false claim

The document says. "Pull the official image: docker pull ghcr.io/hodetech/forgelm:latest". Image variants latest (~12 GB, all extras), slim (~6 GB) and airgap (~30 GB, pre-cached Qwen + Llama Guard).

What the code does. No workflow builds or pushes a container image: no ghcr, docker login or push in .github/workflows. README.md states "no image is published, so build it locally first". The Dockerfile installs core + qlora by default with eval/unsloth optional, and none of the listed variants exist.

Code references. .github/workflows/publish.yml, .github/workflows/ci.yml, README.md:182, Dockerfile:50-67

User impact. Every quick-start command and the air-gap Dockerfile (FROM ghcr.io/...) fail.

Proposed correction. "No image is published. Build it locally: docker build -t forgelm . (build args INSTALL_QLORA (default true), INSTALL_EVAL, INSTALL_UNSLOTH)." Remove the variants table and base the air-gap Dockerfile on FROM forgelm:local.

Turkish mirror. the Turkish page has no such statement

Acceptance criteria

  • Each statement is re-checked against the code at fix time.
  • Documentation listed above is corrected in English and in its Turkish mirror in the same PR.
  • Every finding in this issue is resolved or explicitly closed with a reason.

Found by the October 2026 ForgeLM code and documentation review against commit cab2947. Code links point at that commit; line numbers may have moved since. Finding IDs (CR-…, DOC-…, TECH-…) are stable references for this backlog.

Metadata

Metadata

Assignees

No one assigned

    Labels

    backlog: knownAlready tracked in docs/roadmapblockedWaits for another issue (see Blocked by); set and removed automatically, never by handdocumentationImprovements or additions to documentationseverity: highWrong behaviour or a false claim users rely onsource: review-2026-10Found by the October 2026 code and documentation reviewwave: 1Roadmap wave 1: high severity, small effort

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions