{"record":{"id":"a2e523f2b4c5f311","repo":"gastownhall/beads","slug":"proxied-server-log-path-v","errorCode":null,"errorMessage":"--proxied-server-log-path %v","messagePattern":"--proxied-server-log-path (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/bd/init.go","lineNumber":466,"sourceCode":"\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-config-path requires --proxied-server\")\n\t\t\t}\n\t\t\tif !filepath.IsAbs(serverConfigPath) {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-config-path must be an absolute path, got %q\", serverConfigPath)\n\t\t\t}\n\t\t\tif err := validateProxiedServerConfig(serverConfigPath); err != nil {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-config-path %v\", err)\n\t\t\t}\n\t\t}\n\t\tif serverLogPath != \"\" {\n\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-log-path requires --proxied-server\")\n\t\t\t}\n\t\t\tif !filepath.IsAbs(serverLogPath) {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-log-path must be an absolute path, got %q\", serverLogPath)\n\t\t\t}\n\t\t\tif err := validateProxiedServerLogPath(serverLogPath); err != nil {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-log-path %v\", err)\n\t\t\t}\n\t\t}\n\t\tif serverRootPath != \"\" {\n\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-root-path requires --proxied-server\")\n\t\t\t}\n\t\t\tif !filepath.IsAbs(serverRootPath) {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-root-path must be an absolute path, got %q\", serverRootPath)\n\t\t\t}\n\t\t\tif err := validateProxiedServerRootPath(serverRootPath); err != nil {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-root-path %v\", err)\n\t\t\t}\n\t\t}\n\t\tif serverProxyPort != 0 {\n\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-port requires --proxied-server\")\n\t\t\t}\n\t\t\tif serverProxyPort < 1 || serverProxyPort > 65535 {","sourceCodeStart":448,"sourceCodeEnd":484,"githubUrl":"https://github.com/gastownhall/beads/blob/71377f276968b452ee607177637970a4ff888584/cmd/bd/init.go#L448-L484","documentation":"The log path file failed validateProxiedServerLogPath; init wraps the validator's message behind this prefix. Typical causes are a nonexistent parent directory or a path that is a directory rather than a writable file location.","triggerScenarios":"Running `bd init --proxied-server --proxied-server-log-path <path>` where the parent directory does not exist, the path is not writable, or it points to a directory.","commonSituations":"Typo'd log directories; log path inside a read-only mount; forgetting to mkdir the log directory before init.","solutions":["Read the wrapped detail after '--proxied-server-log-path ' for the exact cause","Create the parent directory (mkdir -p) and ensure write permission","Point the flag at a file path, not an existing directory"],"exampleFix":"// before\nbd init --proxied-server --proxied-server-log-path /var/log/bd/bd.log  # dir missing\n// after\nmkdir -p /var/log/bd && bd init --proxied-server --proxied-server-log-path /var/log/bd/bd.log","handlingStrategy":"validation","validationCode":"LOG=/var/log/bd/bd.log\nmkdir -p \"$(dirname \"$LOG\")\" && [ ! -d \"$LOG\" ] && [ -w \"$(dirname \"$LOG\")\" ] || { echo 'bad log path'; exit 1; }","typeGuard":null,"tryCatchPattern":null,"preventionTips":["mkdir -p the log parent directory before init","Ensure the path is a file location, not an existing directory","Verify write permission on the log directory for the bd process user"],"tags":["cli","config-validation","init","proxied-server","logging"],"backgroundTag":"config-validation-failed","analyzedSha":"71377f276968b452ee607177637970a4ff888584","analyzedAt":"2026-08-30T18:55:39.744Z","schemaVersion":2},"datasetVersion":"2026-08-30T23:17:21.991Z"}