go docker tutorial out of date, missing image docker.io/cockroachdb/cockroach:latest-v20.1

[plastikfan]

Bug report

I'm currently working my way through the go docker tutorial and am stuck on the docker compose command. The git repo I'm working with is https://github.com/docker/docker-gs-ping-dev.

I run into a problem when trying to run the command:

docker compose up --build

which results in the error

[+] up 1/1
 ✘ Image cockroachdb/cockroach:latest-v20.1 Error failed to resolve reference "docker.io/cockroachdb/cockroach:latest-v20.1": docker.io/c... 6.2s
Error response from daemon: failed to resolve reference "docker.io/cockroachdb/cockroach:latest-v20.1": docker.io/cockroachdb/cockroach:latest-v20.1: not found

This looks like the image "docker.io/cockroachdb/cockroach:latest-v20.1" is missing and thus fails.

Please can you update the repo so that other users don't run into this problem. I am not sure what the correct image should be, so any advice on this would be most appreciated, thanks.

Platform

Mac

Version information

Client:
 Version:           29.2.0
 API version:       1.53
 Go version:        go1.25.6
 Git commit:        0b9d198
 Built:             Mon Jan 26 19:25:13 2026
 OS/Arch:           darwin/arm64
 Context:           desktop-linux

Server: Docker Desktop 4.59.1 (217750)
 Engine:
  Version:          29.2.0
  API version:      1.53 (minimum version 1.44)
  Go version:       go1.25.6
  Git commit:       9c62384
  Built:            Mon Jan 26 19:25:48 2026
  OS/Arch:          linux/arm64
  Experimental:     false
 containerd:
  Version:          v2.2.1
  GitCommit:        dea7da592f5d1d2b7755e3a161be07f43fad8f75
 runc:
  Version:          1.3.4
  GitCommit:        v1.3.4-0-gd6d73eb8
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0
Client:
 Version:    29.2.0
 Context:    desktop-linux
 Debug Mode: false
 Plugins:
  ai: Docker AI Agent - Ask Gordon (Docker Inc.)
    Version:  v1.17.2
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-ai
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.31.1-desktop.1
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-buildx
  compose: Docker Compose (Docker Inc.)
    Version:  v5.0.2
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-compose
  debug: Get a shell into any image or container (Docker Inc.)
    Version:  0.0.47
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-debug
  desktop: Docker Desktop commands (Docker Inc.)
    Version:  v0.2.0
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-desktop
  extension: Manages Docker extensions (Docker Inc.)
    Version:  v0.2.31
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-extension
  init: Creates Docker-related starter files for your project (Docker Inc.)
    Version:  v1.4.0
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-init
  mcp: Docker MCP Plugin (Docker Inc.)
    Version:  v0.37.0
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-mcp
  model: Docker Model Runner (Docker Inc.)
    Version:  v1.0.8
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-model
  offload: Docker Offload (Docker Inc.)
    Version:  v0.5.41
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-offload
  pass: Docker Pass Secrets Manager Plugin (beta) (Docker Inc.)
    Version:  v0.0.24
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-pass
  sandbox: Docker Sandbox (Docker Inc.)
    Version:  v0.11.0
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-sandbox
  sbom: View the packaged-based Software Bill Of Materials (SBOM) for an image (Anchore Inc.)
    Version:  0.6.0
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-sbom
  scout: Docker Scout (Docker Inc.)
    Version:  v1.19.0
    Path:     /Users/plastikfan/.docker/cli-plugins/docker-scout

Server:
 Containers: 0
  Running: 0
  Paused: 0
  Stopped: 0
 Images: 9
 Server Version: 29.2.0
 Storage Driver: overlayfs
  driver-type: io.containerd.snapshotter.v1
 Logging Driver: json-file
 Cgroup Driver: cgroupfs
 Cgroup Version: 2
 Plugins:
  Volume: local
  Network: bridge host ipvlan macvlan null overlay
  Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
 CDI spec directories:
  /etc/cdi
  /var/run/cdi
 Swarm: inactive
 Runtimes: io.containerd.runc.v2 runc
 Default Runtime: runc
 Init Binary: docker-init
 containerd version: dea7da592f5d1d2b7755e3a161be07f43fad8f75
 runc version: v1.3.4-0-gd6d73eb8
 init version: de40ad0
 Security Options:
  seccomp
   Profile: builtin
  cgroupns
 Kernel Version: 6.12.67-linuxkit
 Operating System: Docker Desktop
 OSType: linux
 Architecture: aarch64
 CPUs: 10
 Total Memory: 7.653GiB
 Name: docker-desktop
 ID: 56ad9679-e1c1-4225-b11d-769527d5ac7b
 Docker Root Dir: /var/lib/docker
 Debug Mode: false
 HTTP Proxy: http.docker.internal:3128
 HTTPS Proxy: http.docker.internal:3128
 No Proxy: hubproxy.docker.internal
 Labels:
  com.docker.desktop.address=unix:///Users/plastikfan/Library/Containers/com.docker.docker/Data/docker-cli.sock
 Experimental: false
 Insecure Registries:
  hubproxy.docker.internal:5555
  ::1/128
  127.0.0.0/8
 Live Restore Enabled: false

Diagnostics ID

No response

[plastikfan]

EDIT: as of 10 feb 2026, using the latest image of "cockroachdb/cockroach:latest-v24.3" works fine.

[plastikfan]

Oh, I just realised that the tutorial text refers to image: cockroachdb/cockroach:latest-v25.4, but the git repo, contains the out of date image reference.

[plastikfan]

This part of the tutorial needs more clarification as it is confusing and doesn't give enough info to fix the database if it was originally created with the wrong version:

Because of the way you set up your deployment using restart_policy, the failing container is being restarted every 20 seconds. So, in order to fix the problem, you need to log in to the database engine and create the user. You've done it before in [Configure the database engine](https://docs.docker.com/guides/golang/develop/#configure-the-database-engine).

This isn't a big deal. All you have to do is to connect to CockroachDB instance and run the three SQL commands to create the database and the user, as described in [Configure the database engine](https://docs.docker.com/guides/golang/develop/#configure-the-database-engine).

So, log in to the database engine from another terminal:

To fix this I had to run the following:

docker compose down -v

[+] down 4/4
 ✔ Container rest-server            Removed                                                                                                  0.0s
 ✔ Container roach                  Removed                                                                                                  0.0s
 ✔ Network docker-gs-ping-dev_mynet Removed                                                                                                  0.2s
 ✔ Volume docker-gs-ping-dev_roach  Removed

docker volume rm roach

roach

docker compose up --build

[+] Building 0.9s (18/18) FINISHED                                                                                                               
 => [internal] load local bake definitions                                                                                                  0.0s
 => => reading from stdin 646B                                                                                                              0.0s
 => [internal] load build definition from Dockerfile                                                                                        0.0s
 => => transferring dockerfile: 406B                                                                                                        0.0s
 => [internal] load metadata for gcr.io/distroless/base-debian10:latest                                                                     0.3s
 => [internal] load metadata for docker.io/library/golang:1.16-buster                                                                       0.7s
 => [auth] library/golang:pull token for registry-1.docker.io                                                                               0.0s
 => [internal] load .dockerignore                                                                                                           0.0s
 => => transferring context: 2B                                                                                                             0.0s
 => [build 1/7] FROM docker.io/library/golang:1.16-buster@sha256:19bc888c9bc1cd6279263449bb3b8c780190aa14706c93ac44d44c3e01f199c2           0.0s
 => => resolve docker.io/library/golang:1.16-buster@sha256:19bc888c9bc1cd6279263449bb3b8c780190aa14706c93ac44d44c3e01f199c2                 0.0s
 => [stage-1 1/3] FROM gcr.io/distroless/base-debian10:latest@sha256:101798a3b76599762d3528635113f0466dc9655ecba82e8e33d410e2bf5cd319       0.0s
 => => resolve gcr.io/distroless/base-debian10:latest@sha256:101798a3b76599762d3528635113f0466dc9655ecba82e8e33d410e2bf5cd319               0.0s
 => [internal] load build context                                                                                                           0.0s
 => => transferring context: 82B                                                                                                            0.0s
 => CACHED [build 2/7] WORKDIR /app                                                                                                         0.0s
 => CACHED [build 3/7] COPY go.mod .                                                                                                        0.0s
 => CACHED [build 4/7] COPY go.sum .                                                                                                        0.0s
 => CACHED [build 5/7] RUN go mod download                                                                                                  0.0s
 => CACHED [build 6/7] COPY *.go ./                                                                                                         0.0s
 => CACHED [build 7/7] RUN go build -o /docker-gs-ping-roach                                                                                0.0s
 => CACHED [stage-1 2/3] COPY --from=build /docker-gs-ping-roach /docker-gs-ping-roach                                                      0.0s
 => exporting to image                                                                                                                      0.0s
 => => exporting layers                                                                                                                     0.0s
 => => exporting manifest sha256:46dd02b06790c28959eb24ec94f5c33f0f37685892b9d0f84e0871ea55cc18ab                                           0.0s
 => => exporting config sha256:8f3719e45d3a737ef5e567819f75d5b763d972ff934479b61bd96795bb9d9ac8                                             0.0s
 => => exporting attestation manifest sha256:3025790a461d2caa3a10d64d5551f9ac78a910b1a2a3d089cafe1f8bfd73e2b1                               0.0s
 => => exporting manifest list sha256:97cf60cdb8e7d9ceaf9d2976868d538fc61651e96c103ad32b8fb86000b73208                                      0.0s
 => => naming to docker.io/library/docker-gs-ping-dev-docker-gs-ping-roach:latest                                                           0.0s
 => => unpacking to docker.io/library/docker-gs-ping-dev-docker-gs-ping-roach:latest                                                        0.0s
 => resolving provenance for metadata file                                                                                                  0.0s
[+] up 5/5
 ✔ Image docker-gs-ping-dev-docker-gs-ping-roach Built                                                                                       0.9s
 ✔ Network docker-gs-ping-dev_mynet              Created                                                                                     0.0s
 ✔ Volume docker-gs-ping-dev_roach               Created                                                                                     0.0s
 ✔ Container roach                               Created                                                                                     0.0s
 ✔ Container rest-server                         Created                                                                                     0.0s
Attaching to rest-server, roach
rest-server  | 2026/02/10 13:06:06 failed to initialise the store: dial tcp 172.19.0.2:26257: connect: connection refused
rest-server exited with code 1 (restarting)

rest-server exited with code 1 (restarting)
roach        | certificate dir "certs" is successfully set up
roach        | starting node for the initialization process. This could take a couple seconds...
rest-server  | 2026/02/10 13:06:06 failed to initialise the store: dial tcp 172.19.0.2:26257: connect: connection refused
rest-server exited with code 1 (restarting)
roach        | *
roach        | * WARNING: ALL SECURITY CONTROLS HAVE BEEN DISABLED!
roach        | * 
roach        | * This mode is intended for non-production testing only.
roach        | * 
roach        | * In this mode:
roach        | * - Your cluster is open to any client that can access any of your IP addresses.
roach        | * - Intruders with access to your machine or network can observe client-server traffic.
roach        | * - Intruders can log in without password and read or write any data in the cluster.
roach        | * - Intruders can consume all your server's resources and cause unavailability.
roach        | *
roach        | *
roach        | * INFO: To start a secure server without mandating TLS for clients,
roach        | * consider --accept-sql-without-tls instead. For other options, see:
roach        | * 
roach        | * - https://go.crdb.dev/issue-v/53404/v25.4
roach        | * - https://www.cockroachlabs.com/docs/v25.4/secure-a-cluster.html
roach        | *
roach        | *
roach        | * WARNING: Running a server without --sql-addr, with a combined RPC/SQL listener, is deprecated.
roach        | * This feature will be removed in a later version of CockroachDB.
roach        | *
roach        | init node successfully started
roach        | CockroachDB node starting at 2026-02-10 13:06:07.275300302 +0000 UTC m=+0.412820126 (took 0.3s)
roach        | build:               CCL v25.4.3 @ 2026/01/07 18:33:39 (go1.23.12 X:nocoverageredesign)
roach        | malloc_conf:         prof:false,prof_active:true,background_thread:true,thp:never,metadata_thp:disabled,narenas:40,dirty_decay_ms:2000,muzzy_decay_ms:0
roach        | webui:               http://127.0.0.1:8080
roach        | sql:                 postgresql://root@127.0.0.1:26257/defaultdb?sslmode=disable
roach        | sql (JDBC):          jdbc:postgresql://127.0.0.1:26257/defaultdb?sslmode=disable&user=root
roach        | RPC client flags:    /cockroach/cockroach <client cmd> --host=127.0.0.1:26257 --insecure
roach        | logs:                /cockroach/cockroach-data/logs
roach        | temp dir:            /cockroach/cockroach-data/cockroach-temp1163933829
roach        | external I/O path:   /cockroach/cockroach-data/extern
roach        | store[0]:            path=/cockroach/cockroach-data
roach        | clusterID:           2245ff34-ddd2-49aa-a51a-ff8b4587c2db
roach        | status:              initialized new cluster
roach        | nodeID:              1
roach        | database "defaultdb" already exists
rest-server  | 2026/02/10 13:06:07 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)
roach        | start running init files from /docker-entrypoint-initdb.d
roach        | /cockroach/cockroach.sh: ignoring /docker-entrypoint-initdb.d/*
roach        | 
roach        | end running init files from /docker-entrypoint-initdb.d
roach        | "${start_node_query[@]}"
rest-server  | 2026/02/10 13:06:08 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)
rest-server exited with code 1 (restarting)
rest-server  | 2026/02/10 13:06:09 failed to initialise the store: pq: password authentication failed for user totoro
rest-server  | 2026/02/10 13:06:13 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)
rest-server exited with code 1 (restarting)
rest-server  | 2026/02/10 13:06:19 failed to initialise the store: pq: password authentication failed for user totoro
rest-server  | 2026/02/10 13:06:32 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)
rest-server  | 2026/02/10 13:06:58 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)
rest-server  | 2026/02/10 13:07:49 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)
rest-server  | 2026/02/10 13:08:49 failed to initialise the store: pq: password authentication failed for user totoro
rest-server exited with code 1 (restarting)

...

At this point, we can login into the database and create the database mydb and user totoro after logging into the sql REPL with docker exec -it roach ./cockroach sql --insecure. Configure the database engine

This is probably simple if you already know docker, but as a beginner these steps don't come to mind.