{
 "schema_version": 1,
 "generated": "2026-10-31",
 "id": "exo-explore-exo--run-a-separate-test-cluster-with-exo",
 "repo": "exo-explore/exo",
 "repo_url": "https://github.com/exo-explore/exo",
 "repo_slug": "exo-explore-exo",
 "title": "Run a test cluster next to your main one",
 "page_title": "How to run a test cluster next to your main one with Exo",
 "summary": "Give devices their own cluster name so a test setup does not join your main Exo cluster.",
 "who": "A home lab user trying a new Exo build or model without disturbing the cluster everyone uses.",
 "problem": "By default every device with the same Exo version joins the same cluster.",
 "outcome": "Two independent clusters on one network, each with its own name.",
 "steps": [
  "Check each device's version with `uv run exo --version` when running from source",
  "Start test devices from source with `uv run exo --namespace my-cluster`, or set EXO_ZENOH_NAMESPACE",
  "In the app, set Settings, Cluster, Cluster name instead",
  "Keep devices with the same custom name on the same Exo version",
  "Check ~/.exo/exo_log/exo.log for devices that were seen but could not join"
 ],
 "agent_prompt": "With exo-explore/exo running from source, start a separate test cluster with `uv run exo --namespace my-cluster` on <devices>, confirm in the log which namespace each one uses, and make sure my main cluster is untouched.",
 "agents": [
  "claude-code",
  "codex",
  "cursor",
  "gemini-cli"
 ],
 "difficulty": "Intermediate",
 "time": "20 minutes",
 "basis": "readme",
 "caveat": "An app install and a source checkout number versions differently, so they only join each other with the same custom cluster name.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "For the macOS app: a Mac with Apple silicon and macOS Sequoia 15.1 or later",
  "RDMA over Thunderbolt needs macOS Tahoe 26.2 or later",
  "From source: macOS or Linux with Xcode (on Mac), uv, node and rust",
  "Every device on the same network and the same exo version"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/exo-explore-exo/run-a-separate-test-cluster-with-exo/",
 "md": "https://dedupedai.com/use-cases/exo-explore-exo/run-a-separate-test-cluster-with-exo/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/exo-explore-exo--run-a-separate-test-cluster-with-exo.json",
 "api_version": "v1"
}