[{"data":1,"prerenderedAt":544},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-introduction":320,"-getting-started-introduction-surround":541},[4,35,69,109,133,193,228,262,305],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-ph-house",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-ph-rocket-launch",{"title":21,"path":22,"stem":23,"icon":24},"Concepts","\u002Fgetting-started\u002Fconcepts","1.getting-started\u002F3.concepts","i-ph-book-open",{"title":26,"path":27,"stem":28,"icon":29},"Install","\u002Fgetting-started\u002Finstall","1.getting-started\u002F4.install","i-ph-download-simple",{"title":31,"path":32,"stem":33,"icon":34},"What works today","\u002Fgetting-started\u002Fstatus","1.getting-started\u002F5.status","i-ph-list-checks",{"title":21,"icon":6,"path":36,"stem":37,"children":38,"page":6},"\u002Fconcepts","2.concepts",[39,44,49,54,59,64],{"title":40,"path":41,"stem":42,"icon":43},"Architecture","\u002Fconcepts\u002Farchitecture","2.concepts\u002F1.architecture","i-ph-planet",{"title":45,"path":46,"stem":47,"icon":48},"Jobs and durability","\u002Fconcepts\u002Fjobs","2.concepts\u002F2.jobs","i-ph-infinity",{"title":50,"path":51,"stem":52,"icon":53},"Routing","\u002Fconcepts\u002Frouting","2.concepts\u002F3.routing","i-ph-path",{"title":55,"path":56,"stem":57,"icon":58},"Security model","\u002Fconcepts\u002Fsecurity","2.concepts\u002F4.security","i-ph-shield-check",{"title":60,"path":61,"stem":62,"icon":63},"Tenants","\u002Fconcepts\u002Ftenants","2.concepts\u002F5.tenants","i-ph-buildings",{"title":65,"path":66,"stem":67,"icon":68},"Temporal","\u002Fconcepts\u002Ftemporal","2.concepts\u002F6.temporal","i-ph-clock",{"title":70,"icon":6,"path":71,"stem":72,"children":73,"page":6},"Run a fleet","\u002Ffleet","3.fleet",[74,79,84,89,94,99,104],{"title":75,"path":76,"stem":77,"icon":78},"Dev mode","\u002Ffleet\u002Fdev-mode","3.fleet\u002F1.dev-mode","i-ph-laptop",{"title":80,"path":81,"stem":82,"icon":83},"Run a cluster","\u002Ffleet\u002Fcluster","3.fleet\u002F2.cluster","i-ph-hard-drives",{"title":85,"path":86,"stem":87,"icon":88},"Join nodes","\u002Ffleet\u002Fjoin-nodes","3.fleet\u002F3.join-nodes","i-ph-plugs-connected",{"title":90,"path":91,"stem":92,"icon":93},"Manage nodes","\u002Ffleet\u002Fmanage-nodes","3.fleet\u002F4.manage-nodes","i-ph-list-bullets",{"title":95,"path":96,"stem":97,"icon":98},"Secrets","\u002Ffleet\u002Fsecrets","3.fleet\u002F5.secrets","i-ph-key",{"title":100,"path":101,"stem":102,"icon":103},"High availability","\u002Ffleet\u002Fhigh-availability","3.fleet\u002F6.high-availability","i-ph-copy",{"title":105,"path":106,"stem":107,"icon":108},"Upgrades, backups and restores","\u002Ffleet\u002Fupgrades","3.fleet\u002F7.upgrades","i-ph-arrows-clockwise",{"title":110,"icon":6,"path":111,"stem":112,"children":113,"page":6},"Use plugins","\u002Fplugins","4.plugins",[114,119,124,128],{"title":115,"path":116,"stem":117,"icon":118},"What a plugin is","\u002Fplugins\u002Foverview","4.plugins\u002F1.overview","i-ph-puzzle-piece",{"title":120,"path":121,"stem":122,"icon":123},"Install and update","\u002Fplugins\u002Finstall","4.plugins\u002F2.install","i-ph-package",{"title":125,"path":126,"stem":127,"icon":123},"Existing MCP packages","\u002Fplugins\u002Fpackages","4.plugins\u002F3.packages",{"title":129,"path":130,"stem":131,"icon":132},"The catalog","\u002Fplugins\u002Fcatalog","4.plugins\u002F4.catalog","i-ph-books",{"title":134,"icon":6,"path":135,"stem":136,"children":137,"page":6},"Build plugins","\u002Fbuild-plugins","5.build-plugins",[138,143,148,153,158,163,168,173,178,183,188],{"title":139,"path":140,"stem":141,"icon":142},"Your first plugin","\u002Fbuild-plugins\u002Ffirst-plugin","5.build-plugins\u002F1.first-plugin","i-ph-hammer",{"title":144,"path":145,"stem":146,"icon":147},"Harnesses","\u002Fbuild-plugins\u002Fharnesses","5.build-plugins\u002F10.harnesses","i-ph-cpu",{"title":149,"path":150,"stem":151,"icon":152},"Example: support triage","\u002Fbuild-plugins\u002Fexample-support-triage","5.build-plugins\u002F11.example-support-triage","i-ph-lifebuoy",{"title":154,"path":155,"stem":156,"icon":157},"Tools","\u002Fbuild-plugins\u002Ftools","5.build-plugins\u002F2.tools","i-ph-wrench",{"title":159,"path":160,"stem":161,"icon":162},"Agents","\u002Fbuild-plugins\u002Fagents","5.build-plugins\u002F3.agents","i-ph-robot",{"title":164,"path":165,"stem":166,"icon":167},"Skills","\u002Fbuild-plugins\u002Fskills","5.build-plugins\u002F4.skills","i-ph-graduation-cap",{"title":169,"path":170,"stem":171,"icon":172},"Develop and test","\u002Fbuild-plugins\u002Fdevelop-and-test","5.build-plugins\u002F5.develop-and-test","i-ph-flask",{"title":174,"path":175,"stem":176,"icon":177},"Publish and version","\u002Fbuild-plugins\u002Fpublish","5.build-plugins\u002F6.publish","i-ph-tag",{"title":179,"path":180,"stem":181,"icon":182},"Hooks","\u002Fbuild-plugins\u002Fhooks","5.build-plugins\u002F7.hooks","i-ph-anchor",{"title":184,"path":185,"stem":186,"icon":187},"Flows","\u002Fbuild-plugins\u002Fflows","5.build-plugins\u002F8.flows","i-ph-flow-arrow",{"title":189,"path":190,"stem":191,"icon":192},"Evals and quality gates","\u002Fbuild-plugins\u002Fevals","5.build-plugins\u002F9.evals","i-ph-seal-check",{"title":194,"icon":6,"path":195,"stem":196,"children":197,"page":6},"Run agents","\u002Fagents","6.agents",[198,203,208,213,218,223],{"title":199,"path":200,"stem":201,"icon":202},"Run jobs","\u002Fagents\u002Frun-jobs","6.agents\u002F1.run-jobs","i-ph-play",{"title":204,"path":205,"stem":206,"icon":207},"Models and keys","\u002Fagents\u002Fmodels-and-keys","6.agents\u002F2.models-and-keys","i-ph-sparkle",{"title":209,"path":210,"stem":211,"icon":212},"Delegation","\u002Fagents\u002Fdelegation","6.agents\u002F3.delegation","i-ph-git-fork",{"title":214,"path":215,"stem":216,"icon":217},"Contracts and limits","\u002Fagents\u002Fcontracts-and-limits","6.agents\u002F4.contracts-and-limits","i-ph-ruler",{"title":219,"path":220,"stem":221,"icon":222},"Runtime API","\u002Fagents\u002Fruntime-api","6.agents\u002F5.runtime-api","i-ph-plug",{"title":224,"path":225,"stem":226,"icon":227},"Approvals","\u002Fagents\u002Fapprovals","6.agents\u002F6.approvals","i-ph-hand-palm",{"title":229,"icon":6,"path":230,"stem":231,"children":232,"page":6},"Monitor","\u002Fmonitor","7.monitor",[233,238,243,248,253,258],{"title":234,"path":235,"stem":236,"icon":237},"Web UI","\u002Fmonitor\u002Fweb-ui","7.monitor\u002F0.web-ui","i-ph-monitor",{"title":239,"path":240,"stem":241,"icon":242},"Cost and usage","\u002Fmonitor\u002Fcost-and-usage","7.monitor\u002F1.cost-and-usage","i-ph-coins",{"title":244,"path":245,"stem":246,"icon":247},"Node health","\u002Fmonitor\u002Fnodes","7.monitor\u002F2.nodes","i-ph-heartbeat",{"title":249,"path":250,"stem":251,"icon":252},"Job history","\u002Fmonitor\u002Fhistory","7.monitor\u002F3.history","i-ph-clock-counter-clockwise",{"title":254,"path":255,"stem":256,"icon":257},"Tracing and metrics","\u002Fmonitor\u002Fobservability","7.monitor\u002F4.observability","i-ph-chart-line",{"title":259,"path":260,"stem":261,"icon":152},"Troubleshooting","\u002Fmonitor\u002Ftroubleshooting","7.monitor\u002F5.troubleshooting",{"title":263,"icon":6,"path":264,"stem":265,"children":266,"page":6},"Reference","\u002Freference","8.reference",[267,281,286,290,295,300],{"title":268,"icon":269,"path":270,"stem":271,"children":272,"page":6},"CLI","i-ph-terminal-window","\u002Freference\u002Fcli","8.reference\u002F1.cli",[273,277],{"title":274,"path":275,"stem":276},"orchestrator-zero","\u002Freference\u002Fcli\u002Forchestrator-zero","8.reference\u002F1.cli\u002F1.orchestrator-zero",{"title":278,"path":279,"stem":280},"orchestrator-zero-node","\u002Freference\u002Fcli\u002Forchestrator-zero-node","8.reference\u002F1.cli\u002F2.orchestrator-zero-node",{"title":282,"path":283,"stem":284,"icon":285},"oz0-plugin.yaml","\u002Freference\u002Fplugin-manifest","8.reference\u002F2.plugin-manifest","i-ph-file-code",{"title":287,"path":288,"stem":289,"icon":162},"Agent definition","\u002Freference\u002Fagent-definition","8.reference\u002F3.agent-definition",{"title":291,"path":292,"stem":293,"icon":294},"Ports","\u002Freference\u002Fports","8.reference\u002F4.ports","i-ph-network",{"title":296,"path":297,"stem":298,"icon":299},"Environment variables","\u002Freference\u002Fenvironment","8.reference\u002F5.environment","i-ph-brackets-curly",{"title":301,"path":302,"stem":303,"icon":304},"Files and directories","\u002Freference\u002Ffiles","8.reference\u002F6.files","i-ph-tree-structure",{"title":306,"icon":6,"path":307,"stem":308,"children":309,"page":6},"About","\u002Fabout","9.about",[310,315],{"title":311,"path":312,"stem":313,"icon":314},"Licensing","\u002Fabout\u002Flicensing","9.about\u002F1.licensing","i-ph-scales",{"title":316,"path":317,"stem":318,"icon":319},"About these docs","\u002Fabout\u002Fcontributing-docs","9.about\u002F2.contributing-docs","i-ph-pencil-simple",{"id":321,"title":11,"body":322,"description":534,"extension":535,"links":536,"meta":537,"navigation":538,"path":12,"seo":539,"stem":13,"__hash__":540},"docs\u002F1.getting-started\u002F1.introduction.md",{"type":323,"value":324,"toc":526},"minimark",[325,336,341,344,367,370,374,426,435,439,506,509,513,519],[326,327,328,329,335],"p",{},"Orchestrator Zero is a self-hosted orchestration engine for AI agents, built on ",[330,331,65],"a",{"href":332,"rel":333},"https:\u002F\u002Ftemporal.io",[334],"nofollow",". You build agents, tools and skills as plugins. The platform runs them on any machine you join to it, keeps every run durable, routes work to the right machine, meters every token and keeps agents inside the limits you set.",[337,338,340],"h2",{"id":339},"the-problem-it-solves","The problem it solves",[326,342,343],{},"Teams want agents in production, and that usually means building a platform first:",[345,346,347,355,361],"ul",{},[348,349,350,354],"li",{},[351,352,353],"strong",{},"Scattered machines."," GPU boxes, laptops, VMs and clouds, wired together with scripts.",[348,356,357,360],{},[351,358,359],{},"Fragile runs."," A crash or a restart throws away hours of agent work and the money spent on it.",[348,362,363,366],{},[351,364,365],{},"No control."," Nobody can say which agent runs where, with which tools, or at what cost.",[326,368,369],{},"Orchestrator Zero is that platform, as two binaries.",[337,371,373],{"id":372},"how-it-fits-together","How it fits together",[375,376,378,383,394,398,405,409,416,420],"steps",{"level":377},"4",[379,380,382],"h4",{"id":381},"nodes-run-the-work","Nodes run the work",[326,384,385,386,389,390,393],{},"Any machine becomes a ",[351,387,388],{},"node"," with ",[391,392,278],"code",{},". A node dials out to the edge and never opens a port of its own. It runs the agents and tools from the plugins you install.",[379,395,397],{"id":396},"the-edge-is-the-only-door-in","The edge is the only door in",[326,399,400,401,404],{},"The ",[351,402,403],{},"edge"," is the part of the server that nodes and apps talk to. It proxies Temporal, serves the runtime API and the LLM gateway, and checks every call against the node registry.",[379,406,408],{"id":407},"temporal-keeps-runs-durable","Temporal keeps runs durable",[326,410,411,412,415],{},"Every job is a ",[351,413,414],{},"Temporal workflow",". If a node dies halfway, another node with the same agent carries on from the last finished step. Temporal runs inside the server by default.",[379,417,419],{"id":418},"management-keeps-track","Management keeps track",[326,421,422,425],{},[351,423,424],{},"Management"," holds the registry, the certificate authority, tenants, secrets, plugins and usage. It can go down without stopping a single running job.",[326,427,428,429,431,432,434],{},"All of these run in one ",[391,430,274],{}," process by default. A cluster is several of those processes sharing a PostgreSQL database. See ",[330,433,40],{"href":41}," for the full picture.",[337,436,438],{"id":437},"what-you-build-and-what-the-platform-does","What you build, and what the platform does",[440,441,442,455],"table",{},[443,444,445],"thead",{},[446,447,448,452],"tr",{},[449,450,451],"th",{},"You write",[449,453,454],{},"The platform handles",[456,457,458,470,481,495],"tbody",{},[446,459,460,467],{},[461,462,463,466],"td",{},[351,464,465],{},"Tools:"," MCP servers in any language, or an existing MCP package",[461,468,469],{},"Environments, installation on every node, routing, restarts",[446,471,472,478],{},[461,473,474,477],{},[351,475,476],{},"Agents:"," a YAML file with instructions, model, tools and limits",[461,479,480],{},"Placement, durability, delegation, contracts, limits, metering",[446,482,483,492],{},[461,484,485,488,489],{},[351,486,487],{},"Skills:"," folders with a ",[391,490,491],{},"SKILL.md",[461,493,494],{},"Making them available to agents",[446,496,497,503],{},[461,498,499,502],{},[351,500,501],{},"Your apps:"," anything on top",[461,504,505],{},"Jobs, results and cost through the runtime API",[326,507,508],{},"Everything specific to a vendor or a use case is a plugin. The core stays neutral: no models, tools or services are built in. Claude is the first model provider the gateway supports, and others go through the same gateway.",[337,510,512],{"id":511},"where-things-stand","Where things stand",[326,514,515,516,518],{},"Orchestrator Zero is pre-release. Clusters, nodes, plugins, agents, delegation, hooks, flows, evals, the LLM gateway, cost metering, the web UI, health scores, tracing, rollouts of runtimes and plugins, node self-update, backups and purge work today. Pages that describe planned features say so at the top. See ",[330,517,31],{"href":32}," for the details.",[520,521,522,523,525],"tip",{},"New here? The ",[330,524,16],{"href":17}," runs an agent on your own machine in about ten minutes.",{"title":527,"searchDepth":528,"depth":528,"links":529},"",2,[530,531,532,533],{"id":339,"depth":528,"text":340},{"id":372,"depth":528,"text":373},{"id":437,"depth":528,"text":438},{"id":511,"depth":528,"text":512},"What Orchestrator Zero is, what it does for you, and what it leaves to you.","md",null,{},{"icon":14},{"title":11,"description":534},"aJKKhX1eGQDg2r1MGAaXGX3WGm79I_GTQDSW8UErrX0",[536,542],{"title":16,"path":17,"stem":18,"description":543,"icon":19,"children":-1},"Build the binaries, scaffold an agent plugin and run your first job on your own machine.",1791135406265]