{"record":{"id":"31ea19abd50f0dfa","repo":"gastownhall/beads","slug":"proxied-server-port-requires-proxied-server","errorCode":null,"errorMessage":"--proxied-server-port requires --proxied-server","messagePattern":"--proxied-server-port requires --proxied-server","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/bd/init.go","lineNumber":482,"sourceCode":"\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 {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-port must be between 1 and 65535, got %d\", serverProxyPort)\n\t\t\t}\n\t\t}\n\t\tif idleTimeoutSet {\n\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-idle-timeout requires --proxied-server\")\n\t\t\t}\n\t\t\tif serverProxyIdleTimeout < 0 {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-idle-timeout must be 0 (never) or a positive duration, got %s\", serverProxyIdleTimeout)\n\t\t\t}\n\t\t\tif serverProxyIdleTimeout == 0 {\n\t\t\t\tserverProxyIdleTimeout = proxy.IdleTimeoutNever\n\t\t\t}\n\t\t}\n\n\t\texternalProvided := externalHost != \"\" || externalPort != 0 || externalSocketPath != \"\" ||","sourceCodeStart":464,"sourceCodeEnd":500,"githubUrl":"https://github.com/gastownhall/beads/blob/71377f276968b452ee607177637970a4ff888584/cmd/bd/init.go#L464-L500","documentation":"`--proxied-server-port` configures the TCP port of the proxy in front of the managed dolt sql-server and is only meaningful when `--proxied-server` is set. If the port flag is given without `--proxied-server`, init rejects the combination (cmd/bd/init.go:480-483).","triggerScenarios":"Running `bd init --proxied-server-port 8165` without `--proxied-server`; check is `serverProxyPort != 0 && !initProxiedServer`. Also triggered when scripts set the port via flags but the --proxied-server toggle comes only from BEADS_DOLT_PROXIED_SERVER env that is missing.","commonSituations":"Reusing a shared flag template across `bd init --server` and proxied modes; port flag left behind after switching deployment mode from proxied to plain; operator assumed the port flag alone would enable proxy mode.","solutions":["Add `--proxied-server` to the command.","Set BEADS_DOLT_PROXIED_SERVER=1 in the environment instead of the flag.","Drop `--proxied-server-port` if proxy mode is not wanted (default proxy port will not be configured)."],"exampleFix":"// before\nbd init --proxied-server-port 8165\n// after\nbd init --proxied-server --proxied-server-port 8165","handlingStrategy":"validation","validationCode":"#!/usr/bin/env bash\nif [[ -n \"$PROXY_PORT\" ]] && [[ -z \"$PROXIED\" ]]; then\n  echo \"--proxied-server-port requires --proxied-server\" >&2; exit 2\nfi","typeGuard":"func portFlagValid(useProxied bool, portSet bool) bool { return !portSet || useProxied }","tryCatchPattern":"if out, err := exec.Command(\"bd\", \"init\", args...).CombinedOutput(); err != nil {\n    if strings.Contains(string(out), \"--proxied-server-port requires --proxied-server\") {\n        // add --proxied-server or drop the port flag\n    }\n}","preventionTips":["Group --proxied-server with all proxied-server-* flags in a single helper function.","Don't share one flag template between `--server` and proxied init modes.","Audit scripts after switching deployment modes to drop orphaned mode-specific flags."],"tags":["cli","flag-validation","port","proxied-server"],"backgroundTag":"flag-requires-flag","analyzedSha":"71377f276968b452ee607177637970a4ff888584","analyzedAt":"2026-08-30T18:55:39.744Z","schemaVersion":2},"datasetVersion":"2026-08-30T23:17:21.991Z"}