{"record":{"id":"7c8421a1bb2b79c9","repo":"clockworklabs/SpacetimeDB","slug":"server-not-specified-and-no-default-server-configu","errorCode":null,"errorMessage":"Server not specified and no default server configured.","messagePattern":"Server not specified and no default server configured\\.","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/cli/src/subcommands/dev.rs","lineNumber":166,"sourceCode":"    let project_path = args.get_one::<PathBuf>(\"project-path\").unwrap();\n    let module_path_from_cli = args.get_one::<PathBuf>(\"module-path\");\n    let module_bindings_path = args.get_one::<PathBuf>(\"module-bindings-path\").unwrap();\n    let client_language = args.get_one::<Language>(\"client-lang\");\n    let clear_database = args\n        .get_one::<ClearMode>(\"clear-database\")\n        .copied()\n        .unwrap_or(ClearMode::OnConflict);\n    let force = args.get_flag(\"force\");\n\n    // If you don't specify a server, we default to your default server\n    // If you don't have one of those, we default to \"maincloud\"\n    let server_from_cli = args.get_one::<String>(\"server\").map(|s| s.as_str());\n\n    let default_server_name = config.default_server_name().map(|s| s.to_string());\n\n    let mut resolved_server = server_from_cli\n        .or(default_server_name.as_deref())\n        .ok_or_else(|| anyhow::anyhow!(\"Server not specified and no default server configured.\"))?;\n\n    let cwd = std::env::current_dir()?;\n    let mut project_dir = if project_path.is_absolute() {\n        project_path.clone()\n    } else {\n        cwd.join(project_path)\n    };\n\n    if module_bindings_path.is_absolute() {\n        anyhow::bail!(\"Module bindings path must be a relative path\");\n    }\n    let mut module_bindings_dir = project_dir.join(module_bindings_path);\n\n    let mut spacetimedb_dir = match module_path_from_cli {\n        Some(path) => {\n            if path.is_absolute() {\n                path.clone()\n            } else {","sourceCodeStart":148,"sourceCodeEnd":184,"githubUrl":"https://github.com/clockworklabs/SpacetimeDB/blob/524b4487d949b61a07d4f39c862d1290259dfd20/crates/cli/src/subcommands/dev.rs#L148-L184","documentation":"Thrown by `spacetime dev` when no server can be determined. The resolution chain is: explicit `--server` flag, then `default_server_name` from the global CLI config (`~/.local/share/spacetime/config.toml` or equivalent). If both are absent the command refuses to guess and bails. Note: unlike some other commands, `dev` does NOT silently fall back to `maincloud` or `local` for the server name itself.","triggerScenarios":"Fresh install where `spacetime server list`/`spacetime login` was never run, running `spacetime dev` in a project whose `spacetime.json` has no `server` field and no global default server is set, or a corrupted/emptied global config file.","commonSituations":"New machine or CI container with no SpacetimeDB global config; user deleted config.toml; switching between `local` and `maincloud` setups without setting a default.","solutions":["Pass the server explicitly: `spacetime dev --server local` (or `maincloud`)","Set a persistent default once: `spacetime server set local http://localhost:3000 --use-as-default` (or `spacetime server set maincloud --use-as-default`)","Verify with `spacetime server list` that a default exists and points where you expect","In CI, always pass `--server` explicitly rather than relying on agent state"],"exampleFix":"# before\nspacetime dev\n# after\nspacetime dev --server local","handlingStrategy":"validation","validationCode":"# Check a default server exists before running dev\nspacetime server list | grep -q default || spacetime server set local http://localhost:3000 --use-as-default","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run `spacetime server set ... --use-as-default` right after install","In CI/containers, always pass `--server` explicitly","Keep the global config out of .gitignore paths you actually need"],"tags":["cli","configuration","server","spacetimedb"],"backgroundTag":"missing-server-config","analyzedSha":"524b4487d949b61a07d4f39c862d1290259dfd20","analyzedAt":"2026-08-16T23:58:54.611Z","schemaVersion":2},"datasetVersion":"2026-08-17T04:17:16.089Z"}