{"record":{"id":"6213ccfec46618a8","repo":"abiosoft/colima","slug":"error-getting-disk-image-details-w","errorCode":null,"errorMessage":"error getting disk image details: %w","messagePattern":"error getting disk image details: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"environment/vm/lima/disk.go","lineNumber":156,"sourceCode":"\t\tl.limaConf.Provision = append(l.limaConf.Provision, limaconfig.Provision{\n\t\t\tMode:   \"dependency\",\n\t\t\tScript: script,\n\t\t})\n\t}\n}\n\nfunc (l *limaVM) downloadDiskImage(ctx context.Context, conf config.Config) error {\n\tlog := l.Logger(ctx)\n\n\t// use a user specified disk image\n\tif conf.DiskImage != \"\" {\n\t\tif _, err := os.Stat(conf.DiskImage); err != nil {\n\t\t\treturn fmt.Errorf(\"invalid disk image: %w\", err)\n\t\t}\n\n\t\timage, err := limautil.Image(l.limaConf.Arch, conf.Runtime)\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"error getting disk image details: %w\", err)\n\t\t}\n\n\t\tsha := downloader.SHA{Size: 512, Digest: image.Digest}\n\t\tif err := sha.ValidateFile(l.host, conf.DiskImage); err != nil {\n\t\t\tif conf.ForceDiskImage != nil && *conf.ForceDiskImage {\n\t\t\t\tlog.Warnln(\"unable to validate disk image, but continuing as requested...\")\n\t\t\t\timage.Digest = \"\" // clear so lima does not re-validate\n\t\t\t} else {\n\t\t\t\treturn fmt.Errorf(\"disk image must be downloaded from '%s', hash failure: %w\", image.Location, err)\n\t\t\t}\n\t\t}\n\n\t\timage.Location = conf.DiskImage\n\t\tl.limaConf.Images = []limaconfig.File{image}\n\t\treturn nil\n\t}\n\n\t// use a previously cached image","sourceCodeStart":138,"sourceCodeEnd":174,"githubUrl":"https://github.com/abiosoft/colima/blob/c3a5f9184d83a197184f897a9f07eb3c01b3bc88/environment/vm/lima/disk.go#L138-L174","documentation":"After stat-ing a user-supplied disk image, Colima calls limautil.Image(arch, runtime) to obtain the canonical image metadata (location and SHA-512 digest) for the VM architecture and runtime. This error means that metadata lookup failed, so Colima cannot determine which digest the supplied image must match. It is independent of the file itself; it is about Colima's embedded image catalog for the requested arch/runtime combination.","triggerScenarios":"Requesting a disk image for an unsupported architecture/runtime pair (e.g. an arch with no published image for the chosen runtime), or running a Colima build whose embedded image metadata is missing/corrupted for that combination. The error surfaces only when conf.DiskImage is set, since the call precedes digest validation of the user file.","commonSituations":"Running on unusual host architectures (e.g. s390x/ppc64le builds) where no artifact exists; mixing runtime names not present in the catalog; development forks that add runtimes without image entries.","solutions":["Confirm the arch/runtime pair is supported: run `colima start` without a custom disk image and let Colima resolve the default image; if that also fails, the pair is unsupported.","Use the default image resolution (omit the disk-image flag) or pick a runtime with a published image (docker/containerd).","Upgrade Colima to a release that ships image metadata for your architecture.","If you maintain a fork, add the missing arch/runtime entry to limautil's image catalog."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":"Go: if err := vm.DownloadDiskImage(ctx, conf); err != nil { if strings.Contains(err.Error(), \"error getting disk image details\") { /* unsupported arch/runtime pair; switch runtime or omit custom image */ } return err }","preventionTips":["Test arch/runtime combos with a plain start before adding custom images","Keep Colima updated so its image catalog matches supported platforms","Prefer default docker/containerd runtimes on niche architectures"],"tags":["disk-image","architecture","runtime","colima","metadata"],"backgroundTag":null,"analyzedSha":"c3a5f9184d83a197184f897a9f07eb3c01b3bc88","analyzedAt":"2026-08-15T18:58:08.334Z","schemaVersion":2},"datasetVersion":"2026-08-16T03:17:38.424Z"}