{"record":{"id":"2971b0b51ba74f45","repo":"caddyserver/caddy","slug":"couldn-t-determine-admin-api-address-v","errorCode":null,"errorMessage":"couldn't determine admin API address: %v","messagePattern":"couldn't determine admin API address: (.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/commandfuncs.go","lineNumber":363,"sourceCode":"\t\tif os.Getenv(\"HOME\") == \"\" && !hasXDG {\n\t\t\tlogger.Warn(\"$HOME environment variable is empty - please fix; some assets might be stored in ./caddy\")\n\t\t}\n\t}\n\n\t// release the last local logger reference\n\tlogger = nil //nolint:wastedassign,ineffassign\n\n\tselect {}\n}\n\nfunc cmdStop(fl Flags) (int, error) {\n\taddressFlag := fl.String(\"address\")\n\tconfigFlag := fl.String(\"config\")\n\tconfigAdapterFlag := fl.String(\"adapter\")\n\n\tadminAddr, err := DetermineAdminAPIAddress(addressFlag, nil, configFlag, configAdapterFlag)\n\tif err != nil {\n\t\treturn caddy.ExitCodeFailedStartup, fmt.Errorf(\"couldn't determine admin API address: %v\", err)\n\t}\n\n\tresp, err := AdminAPIRequest(adminAddr, http.MethodPost, \"/stop\", nil, nil)\n\tif err != nil {\n\t\tcaddy.Log().Warn(\"failed using API to stop instance\", zap.Error(err))\n\t\treturn caddy.ExitCodeFailedStartup, err\n\t}\n\tdefer resp.Body.Close()\n\n\treturn caddy.ExitCodeSuccess, nil\n}\n\nfunc cmdReload(fl Flags) (int, error) {\n\tconfigFlag := fl.String(\"config\")\n\tconfigAdapterFlag := fl.String(\"adapter\")\n\taddressFlag := fl.String(\"address\")\n\tforceFlag := fl.Bool(\"force\")\n","sourceCodeStart":345,"sourceCodeEnd":381,"githubUrl":"https://github.com/caddyserver/caddy/blob/50e54ee279aa1e504fe218ca49ab6ae16c100410/cmd/commandfuncs.go#L345-L381","documentation":"Error \"couldn't determine admin API address: %v\" thrown in caddyserver/caddy.","triggerScenarios":"Thrown at cmd/commandfuncs.go:363 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Start Caddy with a valid admin endpoint, or pass --address with the admin API address of the running instance.","Check that the admin address in the config is valid and reachable."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"50e54ee279aa1e504fe218ca49ab6ae16c100410","analyzedAt":"2026-08-15T09:20:21.641Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}