From bc76ca97b309ff741b7fc798fa6ed4cfa10ea5f3 Mon Sep 17 00:00:00 2001 From: Lea Anthony Date: Mon, 26 Jan 2026 22:04:31 +1100 Subject: [PATCH] Document Docker API version and fallback behavior Add comment explaining that pullViaDockerAPI uses API v1.44 (Docker 25.0+) and that older versions gracefully fall back to CLI-based pulling. Co-Authored-By: Claude Opus 4.5 --- v3/internal/setupwizard/wizard.go | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/v3/internal/setupwizard/wizard.go b/v3/internal/setupwizard/wizard.go index dfeb6117b..86e4961da 100644 --- a/v3/internal/setupwizard/wizard.go +++ b/v3/internal/setupwizard/wizard.go @@ -725,6 +725,11 @@ func (w *Wizard) startDockerPull() { }() } +// pullViaDockerAPI attempts to pull the image using Docker's HTTP API directly. +// This provides detailed progress tracking with layer-by-layer download status. +// Uses API v1.44 (Docker 25.0+). If this fails for any reason (older Docker version, +// permission issues, etc.), the caller falls back to pullViaDockerCLI which works +// with any Docker version but provides less detailed progress. func (w *Wizard) pullViaDockerAPI() error { socketPath := "/var/run/docker.sock" if runtime.GOOS == "windows" {