gastownhall/beads · error

--proxied-server-log-path requires --proxied-server

Error message

--proxied-server-log-path requires --proxied-server

What it means

--proxied-server-log-path is another proxied-server-only flag; providing it without --proxied-server is rejected because no proxied server will exist to write the log.

Source

Thrown at cmd/bd/init.go:460

			}
		}
		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)
			}
			if err := validateProxiedServerLogPath(serverLogPath); err != nil {
				return fmt.Errorf("--proxied-server-log-path %v", err)
			}
		}
		if serverRootPath != "" {
			if !initProxiedServer {
				return fmt.Errorf("--proxied-server-root-path requires --proxied-server")
			}
			if !filepath.IsAbs(serverRootPath) {
				return fmt.Errorf("--proxied-server-root-path must be an absolute path, got %q", serverRootPath)
			}
			if err := validateProxiedServerRootPath(serverRootPath); err != nil {
				return fmt.Errorf("--proxied-server-root-path %v", err)
			}

View on GitHub (pinned to 71377f2769)

Solutions

1. Add --proxied-server to the command
2. Or remove --proxied-server-log-path

Example fix

// before
bd init --proxied-server-log-path /var/log/bd.log
// after
bd init --proxied-server --proxied-server-log-path /var/log/bd.log

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

When it happens

Trigger: Running `bd init --proxied-server-log-path /var/log/bd.log` without --proxied-server.

Common situations: Same as other companion flags: leftover flags after --proxied-server was removed from a script or docs example.

Related errors

• --proxied-server cannot be combined with --shared-server, --
• --proxied-server-config-path requires --proxied-server
• --server and --proxied-server are mutually exclusive
• --team-server requires --proxied-server
• --proxied-server-config-path must be an absolute path, got %

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