{"record":{"id":"a9cdbf82ad5b82e4","repo":"abiosoft/colima","slug":"cannot-find-s-image-for-s-runtime","errorCode":null,"errorMessage":"cannot find %s image for %s runtime","messagePattern":"cannot find (.+?) image for (.+?) runtime","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"environment/vm/lima/limautil/image.go","lineNumber":57,"sourceCode":"// ImageCached returns if the image for architecture and runtime\n// has been previously downloaded and cached.\nfunc ImageCached(arch environment.Arch, runtime, mirror string) (limaconfig.File, bool) {\n\timg, err := findImage(arch, runtime)\n\tif err != nil {\n\t\treturn img, false\n\t}\n\timg.Location = mirrorURL(img.Location, mirror)\n\n\timage := diskImageFile(downloader.CacheFilename(img.Location))\n\n\timg.Location = image.Location()\n\timg.Digest = \"\"\n\n\treturn img, image.Generated()\n}\n\nfunc findImage(arch environment.Arch, runtime string) (f limaconfig.File, err error) {\n\terr = fmt.Errorf(\"cannot find %s image for %s runtime\", arch, runtime)\n\n\timgFile, ok := diskImageMap[runtime]\n\tif !ok {\n\t\treturn\n\t}\n\timg, ok := imgFile[arch.GoArch()]\n\tif !ok {\n\t\treturn\n\t}\n\treturn img, nil\n}\n\n// Image returns the details of the disk image to download for the arch and runtime.\nfunc Image(arch environment.Arch, runtime string) (limaconfig.File, error) {\n\treturn findImage(arch, runtime)\n}\n\n// DownloadImage downloads the image for arch and runtime.","sourceCodeStart":39,"sourceCodeEnd":75,"githubUrl":"https://github.com/abiosoft/colima/blob/c3a5f9184d83a197184f897a9f07eb3c01b3bc88/environment/vm/lima/limautil/image.go#L39-L75","documentation":"Sentinel error produced by findImage when the runtime/architecture pair has no entry in diskImageMap, the catalog built at init from the embedded images/images.txt. Because err is a named return set upfront, any miss — unknown runtime key or missing GoArch key — returns this error alongside a zero limaconfig.File.","triggerScenarios":"Calling limautil.Image/DownloadImage/ImageCached with a runtime string absent from images/images.txt (typo, unsupported engine) or an architecture with no published image for that runtime (e.g. exotic arch, or windows containers).","commonSituations":"Passing a custom/typo'd runtime name to --runtime; requesting an arch like riscv64 or armv7 that colima ships no image for; a newer runtime that only exists in later colima releases' images.txt.","solutions":["Use a supported runtime: 'docker' or 'containerd' (the names present in the embedded catalog)","Match --arch to a published architecture: aarch64 or x86_64","Upgrade colima — the embedded image catalog grows each release","If building colima from source, verify images/images.txt is present in the embedded FS"],"exampleFix":"# before\ncolima start --runtime dockr    # cannot find aarch64 image for dockr runtime\n# after\ncolima start --runtime docker","handlingStrategy":"validation","validationCode":"// probe the catalog before committing\nif _, err := limautil.Image(arch, runtime); err != nil {\n    return fmt.Errorf(\"unsupported pair, pick docker/containerd and aarch64/x86_64: %w\", err)\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Pin runtime names exactly: 'docker' or 'containerd'","Only request architectures colima publishes images for (aarch64, x86_64)","Building from source? keep images/images.txt in the embedded FS intact"],"tags":["image","runtime","architecture","catalog","boot"],"backgroundTag":null,"analyzedSha":"c3a5f9184d83a197184f897a9f07eb3c01b3bc88","analyzedAt":"2026-08-15T18:58:08.334Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}