{"record":{"id":"2929b95ddab2403f","repo":"clockworklabs/SpacetimeDB","slug":"no-default-server-configuration-set-an-existing-s","errorCode":null,"errorMessage":"No default server configuration.\nSet an existing server as the default with:\n\tspacetime server set-default <server>\nOr add a new server which will become the default:\n\tspacetime server add {server} <url> --default","messagePattern":"No default server configuration\\.\nSet an existing server as the default with:\n\tspacetime server set-default <server>\nOr add a new server which will become the default:\n\tspacetime server add (.+?) <url> --default","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/cli/src/config.rs","lineNumber":205,"sourceCode":"        }\n        Err(no_such_server_error(name_or_host))\n    }\n\n    fn find_server_mut(&mut self, name_or_host: &str) -> anyhow::Result<&mut ServerConfig> {\n        for cfg in &mut self.server_configs {\n            if cfg.nickname.as_deref() == Some(name_or_host) || cfg.host == name_or_host {\n                return Ok(cfg);\n            }\n        }\n        Err(no_such_server_error(name_or_host))\n    }\n\n    fn default_server(&self) -> anyhow::Result<&ServerConfig> {\n        if let Some(default_server) = self.default_server.as_ref() {\n            self.find_server(default_server)\n                .with_context(|| hanging_default_server_context(default_server))\n        } else {\n            Err(anyhow::anyhow!(NO_DEFAULT_SERVER_ERROR_MESSAGE))\n        }\n    }\n\n    fn default_server_mut(&mut self) -> anyhow::Result<&mut ServerConfig> {\n        if let Some(default_server) = self.default_server.as_ref() {\n            let default = default_server.to_string();\n            self.find_server_mut(&default)\n                .with_context(|| hanging_default_server_context(&default))\n        } else {\n            Err(anyhow::anyhow!(NO_DEFAULT_SERVER_ERROR_MESSAGE))\n        }\n    }\n\n    fn add_server(\n        &mut self,\n        host: String,\n        protocol: String,\n        ecdsa_public_key: Option<String>,","sourceCodeStart":187,"sourceCodeEnd":223,"githubUrl":"https://github.com/clockworklabs/SpacetimeDB/blob/524b4487d949b61a07d4f39c862d1290259dfd20/crates/cli/src/config.rs#L187-L223","documentation":"When a command needs a server and none is selected via --server or environment, the CLI falls back to the configured default server; if no default_server is set in the config, default_server (crates/cli/src/config.rs:205) returns this error with remediation commands. Note the sibling case: a default that points at a missing server yields the different 'hanging default' context error.","triggerScenarios":"Running any server-contacting command (publish, login, logs, call) with no default server configured — fresh install, config file deleted, or the default was removed via spacetime server remove.","commonSituations":"New machine or CI container with no ~/.config/.spacetime config; after clearing or editing the config by hand; scripts assuming a default already exists.","solutions":["Set a default from an existing server: spacetime server set-default <server>","Or add a new one and make it the default in a single step: spacetime server add <server> --url <url> --default","Bypass the default lookup by passing --server explicitly or exporting SPACETIMEDB_SERVER in scripts"],"exampleFix":"# before\nspacetime publish my-module   # Error: No default server configuration.\n\n# after\nspacetime server set-default mainnet\nspacetime publish my-module","handlingStrategy":"validation","validationCode":"# Make scripts self-healing: guarantee a default before any command that needs one:\nspacetime server list 2>/dev/null | grep -q . \\\n  || spacetime server add mainnet --url https://mainnet.spacetimedb.com --default\nspacetime publish my-module","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Include spacetime server add ... --default in every environment bootstrap (machine, CI, container)","Prefer --server or SPACETIMEDB_SERVER in automation over relying on a default","After spacetime server remove, immediately set a new default"],"tags":["cli","configuration","server","spacetimedb"],"backgroundTag":"no-default-server-configured","analyzedSha":"524b4487d949b61a07d4f39c862d1290259dfd20","analyzedAt":"2026-08-16T23:58:54.611Z","schemaVersion":2},"datasetVersion":"2026-08-17T04:17:16.089Z"}