gastownhall/beads · error

--team-server requires --proxied-server

Error message

--team-server requires --proxied-server

What it means

--team-server is only meaningful in proxied-server mode; enabling it without --proxied-server is rejected at init flag validation.

Source

Thrown at cmd/bd/init.go:445

		initEvt := metrics.NewCommandEvent("init-" + resolveInitDoltMode(initProxiedServer, sharedServer, initServerMode))
		defer func() {
			if c := metrics.Global(); c != nil {
				c.CloseEventAndAdd(initEvt)
			}
		}()

		if initProxiedServer && initServerMode {
			return fmt.Errorf("--server and --proxied-server are mutually exclusive")
		}
		if initProxiedServer {
			if sharedServer || externalServer ||
				serverHost != "" || serverPort != 0 || serverSocket != "" || serverUser != "" || cmd.Flags().Changed("server-tls") {
				return fmt.Errorf("--proxied-server cannot be combined with --shared-server, --external, or any --server-* flag")
			}
		}
		if initTeamServer && !initProxiedServer {
			return fmt.Errorf("--team-server requires --proxied-server")
		}
		if serverConfigPath != "" {
			if !initProxiedServer {
				return fmt.Errorf("--proxied-server-config-path requires --proxied-server")
			}
			if !filepath.IsAbs(serverConfigPath) {
				return fmt.Errorf("--proxied-server-config-path must be an absolute path, got %q", serverConfigPath)
			}
			if err := validateProxiedServerConfig(serverConfigPath); err != nil {
				return fmt.Errorf("--proxied-server-config-path %v", err)
			}
		}
		if serverLogPath != "" {
			if !initProxiedServer {
				return fmt.Errorf("--proxied-server-log-path requires --proxied-server")
			}
			if !filepath.IsAbs(serverLogPath) {
				return fmt.Errorf("--proxied-server-log-path must be an absolute path, got %q", serverLogPath)

View on GitHub (pinned to 71377f2769)

Solutions

  1. Add --proxied-server to the same command
  2. Or drop --team-server if proxied-server mode is not wanted

Example fix

// before
bd init --team-server
// after
bd init --proxied-server --team-server
Defensive patterns

Strategy: validation

Validate before calling

# --team-server requires --proxied-server
if [[ "$FLAGS" == *--team-server* && "$FLAGS" != *--proxied-server* ]]; then
  echo 'add --proxied-server'; exit 1
fi

Prevention

When it happens

Trigger: Running `bd init --team-server` (initTeamServer true) while --proxied-server is absent (initProxiedServer false).

Common situations: Adding --team-server to a plain `bd init` to 'enable teams' without realizing it is a modifier of proxied-server mode, not a standalone mode.

Related errors

AI-assisted analysis of gastownhall/beads@71377f2769 (2026-08-30). Data as JSON: /api/errors/613ad16972189dc0. Report an issue: GitHub.