[{"data":1,"prerenderedAt":618},["ShallowReactive",2],{"navigation_docs":3,"-reference-cli-orchestrator-zero-node":320,"-reference-cli-orchestrator-zero-node-surround":613},[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":278,"body":322,"description":606,"extension":607,"links":608,"meta":609,"navigation":610,"path":279,"seo":611,"stem":280,"__hash__":612},"docs\u002F8.reference\u002F1.cli\u002F2.orchestrator-zero-node.md",{"type":323,"value":324,"toc":599},"minimark",[325,329,334,337,399,404,411,436,518,523,526,540,573,578,581,595],[326,327,328],"p",{},"Orchestrator Zero node: runs agents on this machine",[330,331,333],"h2",{"id":332},"global-flags","Global flags",[326,335,336],{},"These work with every command.",[338,339,340,359],"table",{},[341,342,343],"thead",{},[344,345,346,350,353,356],"tr",{},[347,348,349],"th",{},"Flag",[347,351,352],{},"Type",[347,354,355],{},"Default",[347,357,358],{},"Description",[360,361,362,382],"tbody",{},[344,363,364,371,374,379],{},[365,366,367],"td",{},[368,369,370],"code",{},"--data-dir",[365,372,373],{},"string",[365,375,376],{},[368,377,378],{},"~\u002F.local\u002Fshare\u002Forchestrator-zero-node",[365,380,381],{},"where the node keeps its identity, uv, Python, runtimes and state",[344,383,384,389,391,396],{},[365,385,386],{},[368,387,388],{},"--log-level",[365,390,373],{},[365,392,393],{},[368,394,395],{},"info",[365,397,398],{},"log level: debug, info, warn or error",[330,400,402],{"id":401},"join",[368,403,401],{},[326,405,406,407,410],{},"Join a cluster. The node creates its key locally (it never leaves the machine) and checks the server against the CA hash in the join token or --ca-hash before it sends anything. With a valid token it is accepted at once; without one it waits until an operator runs ",[368,408,409],{},"orchestrator-zero node accept",".",[412,413,418],"pre",{"className":414,"code":415,"language":416,"meta":417,"style":417},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","orchestrator-zero-node join [flags]\n","bash","",[368,419,420],{"__ignoreMap":417},[421,422,425,428,432],"span",{"class":423,"line":424},"line",1,[421,426,278],{"class":427},"sBMFI",[421,429,431],{"class":430},"sfazB"," join",[421,433,435],{"class":434},"sTEyZ"," [flags]\n",[338,437,438,450],{},[341,439,440],{},[344,441,442,444,446,448],{},[347,443,349],{},[347,445,352],{},[347,447,355],{},[347,449,358],{},[360,451,452,466,483,504],{},[344,453,454,459,461,463],{},[365,455,456],{},[368,457,458],{},"--ca-hash",[365,460,373],{},[365,462],{},[365,464,465],{},"cluster CA hash (sha256:...) to join without a token and wait for approval",[344,467,468,473,475,480],{},[365,469,470],{},[368,471,472],{},"--name",[365,474,373],{},[365,476,477],{},[368,478,479],{},"host name",[365,481,482],{},"display name",[344,484,485,490,492,494],{},[365,486,487],{},[368,488,489],{},"--server",[365,491,373],{},[365,493],{},[365,495,496,497,503],{},"edge address, for example ",[498,499,500],"a",{"href":500,"rel":501},"https:\u002F\u002Fedge.example.com:7443",[502],"nofollow"," (required)",[344,505,506,511,513,515],{},[365,507,508],{},[368,509,510],{},"--token",[365,512,373],{},[365,514],{},[365,516,517],{},"join token from orchestrator-zero token create (or set OZ0_JOIN_TOKEN)",[330,519,521],{"id":520},"run",[368,522,520],{},[326,524,525],{},"Run the node in the foreground. It installs uv, Python and the runtime bundle if they are missing, opens the control stream to the edge, and runs the runtime on the task queues the edge assigns, behind a local proxy that holds the node's certificate. Certificates are renewed in place; a blocked node stops its runtime and waits.",[412,527,529],{"className":414,"code":528,"language":416,"meta":417,"style":417},"orchestrator-zero-node run [flags]\n",[368,530,531],{"__ignoreMap":417},[421,532,533,535,538],{"class":423,"line":424},[421,534,278],{"class":427},[421,536,537],{"class":430}," run",[421,539,435],{"class":434},[338,541,542,554],{},[341,543,544],{},[344,545,546,548,550,552],{},[347,547,349],{},[347,549,352],{},[347,551,355],{},[347,553,358],{},[360,555,556],{},[344,557,558,563,565,570],{},[365,559,560],{},[368,561,562],{},"--runtime-bundle",[365,564,373],{},[365,566,567],{},[368,568,569],{},"download the edge's, which make dist builds",[365,571,572],{},"runtime bundle directory",[330,574,576],{"id":575},"version",[368,577,575],{},[326,579,580],{},"Print the version",[412,582,584],{"className":414,"code":583,"language":416,"meta":417,"style":417},"orchestrator-zero-node version [flags]\n",[368,585,586],{"__ignoreMap":417},[421,587,588,590,593],{"class":423,"line":424},[421,589,278],{"class":427},[421,591,592],{"class":430}," version",[421,594,435],{"class":434},[596,597,598],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":417,"searchDepth":600,"depth":600,"links":601},2,[602,603,604,605],{"id":332,"depth":600,"text":333},{"id":401,"depth":600,"text":401},{"id":520,"depth":600,"text":520},{"id":575,"depth":600,"text":575},"The node binary: join a cluster and run agents on this machine.","md",null,{},true,{"title":278,"description":606},"vow863eOtJBwspcJIY-J9D0-E4k_G_o-BZannd1tIpo",[614,616],{"title":274,"path":275,"stem":276,"description":615,"children":-1},"The server binary and the operator CLI: run servers, manage nodes, plugins, secrets and jobs.",{"title":282,"path":283,"stem":284,"description":617,"icon":285,"children":-1},"Every field of the plugin manifest, and the rules plugin lint checks.",1791135415262]