{"record":{"id":"b566c998ecc4a914","repo":"gastownhall/beads","slug":"proxied-server-cannot-be-combined-with-shared","errorCode":null,"errorMessage":"--proxied-server cannot be combined with --shared-server, --external, or any --server-* flag","messagePattern":"--proxied-server cannot be combined with --shared-server, --external, or any --server-\\* flag","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/bd/init.go","lineNumber":441,"sourceCode":"\t\texternalKeepAlive, _ := cmd.Flags().GetDuration(\"proxied-server-external-keep-alive\")\n\t\tif os.Getenv(\"BEADS_DOLT_PROXIED_SERVER\") == \"1\" {\n\t\t\tinitProxiedServer = true\n\t\t}\n\n\t\tinitEvt := metrics.NewCommandEvent(\"init-\" + resolveInitDoltMode(initProxiedServer, sharedServer, initServerMode))\n\t\tdefer func() {\n\t\t\tif c := metrics.Global(); c != nil {\n\t\t\t\tc.CloseEventAndAdd(initEvt)\n\t\t\t}\n\t\t}()\n\n\t\tif initProxiedServer && initServerMode {\n\t\t\treturn fmt.Errorf(\"--server and --proxied-server are mutually exclusive\")\n\t\t}\n\t\tif initProxiedServer {\n\t\t\tif sharedServer || externalServer ||\n\t\t\t\tserverHost != \"\" || serverPort != 0 || serverSocket != \"\" || serverUser != \"\" || cmd.Flags().Changed(\"server-tls\") {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server cannot be combined with --shared-server, --external, or any --server-* flag\")\n\t\t\t}\n\t\t}\n\t\tif initTeamServer && !initProxiedServer {\n\t\t\treturn fmt.Errorf(\"--team-server requires --proxied-server\")\n\t\t}\n\t\tif serverConfigPath != \"\" {\n\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 {","sourceCodeStart":423,"sourceCodeEnd":459,"githubUrl":"https://github.com/gastownhall/beads/blob/71377f276968b452ee607177637970a4ff888584/cmd/bd/init.go#L423-L459","documentation":"--proxied-server cannot be combined with --shared-server, --external, or any --server-* flag (host, port, socket, user, tls). Those options configure other/legacy server modes and conflict with the proxied-server mode's own config file.","triggerScenarios":"Running `bd init --proxied-server` together with any of: --shared-server, --external, --server-host, --server-port, --server-socket, --server-user, or an explicitly changed --server-tls flag.","commonSituations":"Migrating an init command from shared/external server mode to proxied-server and leaving old --server-* flags in place; CI scripts accumulating server flags over time.","solutions":["Delete all --server-*, --shared-server, and --external flags from the command; keep only --proxied-server plus --proxied-server-* paths","Move server connection settings into the proxied-server config file passed via --proxied-server-config-path"],"exampleFix":"// before\nbd init --proxied-server --server-host localhost --server-port 8080\n// after\nbd init --proxied-server --proxied-server-config-path /etc/bd/proxied.json","handlingStrategy":"validation","validationCode":"# ensure no conflicting flags when --proxied-server is set\nif [[ \"$FLAGS\" == *--proxied-server* ]]; then\n  if [[ \"$FLAGS\" == *--shared-server* || \"$FLAGS\" == *--external* || \"$FLAGS\" == *--server-* ]]; then\n    echo 'conflict: strip --shared-server/--external/--server-* flags'; exit 1\n  fi\nfi","typeGuard":null,"tryCatchPattern":null,"preventionTips":["When migrating to proxied-server, delete legacy --server-* flags rather than leaving them","Keep proxied server settings in the config file, not command-line server flags","Review generated init scripts for accumulated flags"],"tags":["cli","flag-conflict","init","proxied-server"],"backgroundTag":"mutually-exclusive-flags","analyzedSha":"71377f276968b452ee607177637970a4ff888584","analyzedAt":"2026-08-30T18:55:39.744Z","schemaVersion":2},"datasetVersion":"2026-08-30T23:17:21.991Z"}