{"record":{"id":"f1b655dee68aadfe","repo":"dagger/dagger","slug":"determine-latest-released-version-w","errorCode":null,"errorMessage":"determine latest released version: %w","messagePattern":"determine latest released version: %w","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/cmd/dagger/module_cmd.go","lineNumber":213,"sourceCode":"\tUse:     \"require <version>\",\n\tShort:   \"Set the module's required engine version\",\n\tExample: \"dagger module engine require v0.21.0\",\n\tArgs:    cobra.ExactArgs(1),\n\tRunE: func(cmd *cobra.Command, args []string) error {\n\t\treturn withEngine(cmd.Context(), client.Params{}, func(ctx context.Context, engineClient *client.Client) error {\n\t\t\treturn setModuleEngineVersion(ctx, cmd.OutOrStdout(), engineClient.Dagger(), args[0])\n\t\t})\n\t},\n}\n\nvar moduleEngineRequireLatestCmd = &cobra.Command{\n\tUse:   \"require-latest\",\n\tShort: \"Set the module's required engine version to the latest released version\",\n\tArgs:  cobra.NoArgs,\n\tRunE: func(cmd *cobra.Command, _ []string) error {\n\t\tlatest, err := latestVersion(cmd.Context())\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"determine latest released version: %w\", err)\n\t\t}\n\t\treturn withEngine(cmd.Context(), client.Params{}, func(ctx context.Context, engineClient *client.Client) error {\n\t\t\treturn setModuleEngineVersion(ctx, cmd.OutOrStdout(), engineClient.Dagger(), latest)\n\t\t})\n\t},\n}\n\nvar moduleEngineRequireCurrentCmd = &cobra.Command{\n\tUse:   \"require-current\",\n\tShort: \"Set the module's required engine version to the currently running engine version\",\n\tArgs:  cobra.NoArgs,\n\tRunE: func(cmd *cobra.Command, _ []string) error {\n\t\treturn withEngine(cmd.Context(), client.Params{}, func(ctx context.Context, engineClient *client.Client) error {\n\t\t\tdag := engineClient.Dagger()\n\t\t\tcurrent, err := dag.Version(ctx)\n\t\t\tif err != nil {\n\t\t\t\treturn fmt.Errorf(\"determine current engine version: %w\", err)\n\t\t\t}","sourceCodeStart":195,"sourceCodeEnd":231,"githubUrl":"https://github.com/dagger/dagger/blob/82ba2681dbe30d3547a1dc50ea495900ab5b6047/internal/cmd/dagger/module_cmd.go#L195-L231","documentation":"Wraps a failure from latestVersion while running 'dagger mod require-latest', which resolves the latest released engine version and pins it in the module config. The lookup (typically a network call to release metadata) failed, so the module version cannot be set.","triggerScenarios":"Running 'dagger mod require-latest' when latestVersion(cmd.Context()) fails — unreachable release endpoint, offline machine, proxy blocking the request, or malformed release data.","commonSituations":"Corporate proxy/firewall blocking GitHub releases; DNS failure; running fully offline; a broken release metadata endpoint.","solutions":["Check network/proxy access to the release metadata source","Pin a version explicitly instead (edit dagger.json engine version or use require with a specific version)","Retry later if the release service is temporarily down"],"exampleFix":"// before (offline)\ndagger mod require-latest\n// determine latest released version: ...\n// after: pin explicitly\ndagger mod require v0.15.0  # or edit dagger.json engineVersion","handlingStrategy":"fallback","validationCode":"// quick reachability probe before resolving latest\nresp, err := http.Head(releaseMetaURL)\nif err != nil || resp.StatusCode != 200 {\n\treturn errors.New(\"release metadata endpoint unreachable\")\n}","typeGuard":null,"tryCatchPattern":"latest, err := latestVersion(ctx)\nif err != nil {\n\tif pin := pinnedFallbackVersion(); pin != \"\" {\n\t\treturn setModuleEngineVersion(ctx, out, dag, pin)\n\t}\n\treturn fmt.Errorf(\"determine latest released version: %w\", err)\n}","preventionTips":["Configure proxy env vars (HTTPS_PROXY) if behind a corporate firewall","Keep a known-good fallback engine version for offline use","Prefer explicitly pinned engine versions in CI for determinism"],"tags":["versioning","network","cli","engine"],"backgroundTag":"latest-version-lookup-failed","analyzedSha":"82ba2681dbe30d3547a1dc50ea495900ab5b6047","analyzedAt":"2026-09-05T07:21:37.930Z","contentChangedAt":"2026-09-05T07:21:37.930Z","schemaVersion":2},"datasetVersion":"2026-09-12T12:17:11.808Z"}