@myagentroam/server 0.13.4 → 0.13.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (397) hide show
  1. package/dist/quick-start/node-runtime.js +21 -3
  2. package/dist/quick-start/run.js +11 -2
  3. package/node_modules/@myagentroam/protocol/dist/index.d.ts +8 -0
  4. package/node_modules/@myagentroam/protocol/dist/index.js +2 -0
  5. package/node_modules/@myagentroam/protocol/package.json +1 -1
  6. package/node_modules/@myagentroam/server-core/dist/mcp-service.js +5 -3
  7. package/node_modules/@myagentroam/server-core/dist/mysql-node-identity.d.ts +5 -0
  8. package/node_modules/@myagentroam/server-core/dist/mysql-node-identity.js +31 -0
  9. package/node_modules/@myagentroam/server-core/dist/skill-source-service.js +5 -3
  10. package/node_modules/@myagentroam/server-core/package.json +2 -2
  11. package/node_modules/@myagentroam-enterprise/server-implementation/dist/cli-messages.en-US.d.ts +1 -0
  12. package/node_modules/@myagentroam-enterprise/server-implementation/dist/cli-messages.en-US.js +1 -0
  13. package/node_modules/@myagentroam-enterprise/server-implementation/dist/cli-messages.zh-CN.d.ts +1 -0
  14. package/node_modules/@myagentroam-enterprise/server-implementation/dist/cli-messages.zh-CN.js +1 -0
  15. package/node_modules/@myagentroam-enterprise/server-implementation/dist/composition/quick-start-node-bootstrap.d.ts +5 -1
  16. package/node_modules/@myagentroam-enterprise/server-implementation/dist/composition/quick-start-node-bootstrap.js +9 -1
  17. package/node_modules/@myagentroam-enterprise/server-implementation/dist/composition/server-application.js +1 -0
  18. package/node_modules/@myagentroam-enterprise/server-implementation/dist/license/management-gate.js +3 -2
  19. package/node_modules/@myagentroam-enterprise/server-implementation/dist/mysql/server-database.d.ts +4 -0
  20. package/node_modules/@myagentroam-enterprise/server-implementation/dist/mysql/server-database.js +3 -0
  21. package/node_modules/@myagentroam-enterprise/server-implementation/dist/rbac/authorization-service.js +7 -1
  22. package/node_modules/@myagentroam-enterprise/server-implementation/package.json +3 -3
  23. package/package.json +6 -6
  24. package/web/assets/{AuditManagementPage-DnsGADhX.js → AuditManagementPage-fDpTFGAJ.js} +1 -1
  25. package/web/assets/{BusyIndicator-DuQN1wm-.js → BusyIndicator-81gYfHFI.js} +1 -1
  26. package/web/assets/{CodeFileEditor-BIIXeX-W.js → CodeFileEditor-BWA7aZwM.js} +3 -3
  27. package/web/assets/{ConversationTemplateManagementPage-Cq610Ift.js → ConversationTemplateManagementPage-CMwsINqq.js} +1 -1
  28. package/web/assets/{ConversationTemplateManagementPage-Bo4oyW8_.js → ConversationTemplateManagementPage-DM2WlZlh.js} +1 -1
  29. package/web/assets/{EnterpriseUserManagementPage-CaTrDqbs.js → EnterpriseUserManagementPage-BKCNfftS.js} +1 -1
  30. package/web/assets/{EnvironmentSecretManager-BsrTY2rn.js → EnvironmentSecretManager-jWSJQLLY.js} +1 -1
  31. package/web/assets/{FilePreviewLoading-RwWQoi6Y.js → FilePreviewLoading-EXabASKn.js} +1 -1
  32. package/web/assets/HtmlPreviewFrame-DQimcizh.js +5 -0
  33. package/web/assets/{HtmlPreviewFrame-CXd4x0y-.css → HtmlPreviewFrame-D_oKBx6Z.css} +1 -1
  34. package/web/assets/{LicenseManagementPage-7_EsyrhF.js → LicenseManagementPage-li8NTgz0.js} +1 -1
  35. package/web/assets/{ManagementPagination-2xmt9Zfx.js → ManagementPagination-DC_Jtk72.js} +1 -1
  36. package/web/assets/{MarAgentModelManagementPage-B5_l5kMw.js → MarAgentModelManagementPage-BhuEt5ck.js} +1 -1
  37. package/web/assets/{MarAgentModelManagementPage-CjMpM_RC.js → MarAgentModelManagementPage-DtQDSKsm.js} +1 -1
  38. package/web/assets/{MarIcon-Bey6vvFS.js → MarIcon-DRzNI1TJ.js} +1 -1
  39. package/web/assets/{MarkdownFilePreview-DroSJppq.js → MarkdownFilePreview-DRxwzEkP.js} +2 -2
  40. package/web/assets/{McpDetailsDialog-BrklXkCL.js → McpDetailsDialog-C4hLhwaZ.js} +1 -1
  41. package/web/assets/{McpSourceManagementPage-CCugQvg2.js → McpSourceManagementPage-B4o2soUo.js} +1 -1
  42. package/web/assets/{McpSourceManagementPage-BBw8Fnb7.js → McpSourceManagementPage-ChCP_9Wx.js} +1 -1
  43. package/web/assets/{NodeDetailsDialogs-U0lssvGT.js → NodeDetailsDialogs-jvve59Rc.js} +1 -1
  44. package/web/assets/NodeManagementPage-BaoMHEc6.js +1 -0
  45. package/web/assets/NodeManagementPage-DcE_Tno8.js +1 -0
  46. package/web/assets/{OAuthManagementPage-BeiBNSsN.js → OAuthManagementPage-oSorMLvE.js} +1 -1
  47. package/web/assets/{OrganizationManagementPage-CS9sBwhZ.js → OrganizationManagementPage-CEcAvCJe.js} +1 -1
  48. package/web/assets/{ResourceManagementPanel-Ck53eFHZ.js → ResourceManagementPanel-kqq0Svx_.js} +1 -1
  49. package/web/assets/{ResourceManagementPanel.vue_vue_type_script_setup_true_lang-D1vZJR_l.js → ResourceManagementPanel.vue_vue_type_script_setup_true_lang-DWpc58cT.js} +1 -1
  50. package/web/assets/{SecretManagementPage-CkoIPpRk.js → SecretManagementPage-CXmPmuQ7.js} +1 -1
  51. package/web/assets/SecretManagementPage-DnHmkYKn.js +1 -0
  52. package/web/assets/{SecretManagementPage.vue_vue_type_script_setup_true_lang-Bq3JYt0N.js → SecretManagementPage.vue_vue_type_script_setup_true_lang-DBmhix-s.js} +1 -1
  53. package/web/assets/{SessionSharePage-UYao-99J.js → SessionSharePage-Bfibf3C2.js} +2 -2
  54. package/web/assets/{SettingsContent-Cdhq2mMs.js → SettingsContent-BQYXFW0-.js} +1 -1
  55. package/web/assets/{SettingsContent-CxwrhDv3.js → SettingsContent-KFZsk8Yv.js} +1 -1
  56. package/web/assets/{SkillCenterPage-7USQN-DP.js → SkillCenterPage-5lJUA9pl.js} +1 -1
  57. package/web/assets/SkillCenterPage-BmqIek5Q.js +1 -0
  58. package/web/assets/{SkillDetailsDialog-BsiPRfbz.js → SkillDetailsDialog-CrN5o6Jk.js} +1 -1
  59. package/web/assets/{SkillSourceManagementPage-DFnaYnRe.js → SkillSourceManagementPage-Di_lVA5-.js} +1 -1
  60. package/web/assets/{SkillSourceManagementPage-BvOdElvU.js → SkillSourceManagementPage-DpenHp3H.js} +1 -1
  61. package/web/assets/{StandaloneFilePreviewPage-Cb1MpQfh.js → StandaloneFilePreviewPage-_Lh1H6-k.js} +1 -1
  62. package/web/assets/{SystemConfigurationPage-DME6cns0.js → SystemConfigurationPage-BpCsGW-2.js} +1 -1
  63. package/web/assets/SystemConfigurationPage-BqqdmrAK.js +1 -0
  64. package/web/assets/{SystemInformationPage-DGZWfrXE.js → SystemInformationPage-G9WA9kpj.js} +1 -1
  65. package/web/assets/{TerminalTabView-CuQzSev1.js → TerminalTabView-KFAT6dN-.js} +1 -1
  66. package/web/assets/{WorkbenchPage-B7W9kyOw.js → WorkbenchPage-BQdwbvse.js} +15 -15
  67. package/web/assets/WorkbenchPage-ptvzMUTa.css +1 -0
  68. package/web/assets/WorkspaceManagementPage-BYtbXfHc.js +1 -0
  69. package/web/assets/WorkspaceManagementPage-C-9iCpGW.js +1 -0
  70. package/web/assets/{_baseIteratee-3ynz4yPF.js → _baseIteratee-CEjLB6P0.js} +1 -1
  71. package/web/assets/{abnfDiagram-VCTEODGH-DupmQ6Er.js → abnfDiagram-VCTEODGH-DwwJ-B6X.js} +1 -1
  72. package/web/assets/{advancedFormat-Bqm4Kq1b.js → advancedFormat-DwAKrlQQ.js} +1 -1
  73. package/web/assets/{arc-Fq0BJf1Q.js → arc-BhUv0GFi.js} +1 -1
  74. package/web/assets/{architectureDiagram-5GKGNRK7-B4EFAJN2.js → architectureDiagram-5GKGNRK7-BYwr4pOI.js} +1 -1
  75. package/web/assets/{blockDiagram-OSKFZWR5-B75Yxltl.js → blockDiagram-OSKFZWR5-BQ0G5RBd.js} +1 -1
  76. package/web/assets/{c4Diagram-7LVT6UL2-2IJLHGl0.js → c4Diagram-7LVT6UL2-DLmelPF5.js} +1 -1
  77. package/web/assets/{catalog-ownership-service-BMQL4KAM.js → catalog-ownership-service-BQ72dnlA.js} +1 -1
  78. package/web/assets/{catalog-page-service-Cnb4fp1m.js → catalog-page-service-D4eWT4uF.js} +1 -1
  79. package/web/assets/channel-BAHh016e.js +1 -0
  80. package/web/assets/{chunk-2Q5K7J3B-BbIlpi0m.js → chunk-2Q5K7J3B-CQf0ME4y.js} +1 -1
  81. package/web/assets/{chunk-5VM5RSS4-Ds5gdCgX.js → chunk-5VM5RSS4-DQY_-Ks6.js} +1 -1
  82. package/web/assets/{chunk-F27PBJKO-DBafPcM9.js → chunk-F27PBJKO-CklCJyS6.js} +1 -1
  83. package/web/assets/{chunk-HLEWEB6X-Ctl85JUs.js → chunk-HLEWEB6X-Ofa5loFJ.js} +1 -1
  84. package/web/assets/{chunk-JWPE2WC7-Df0cT3j7.js → chunk-JWPE2WC7-Dc7083sU.js} +1 -1
  85. package/web/assets/{chunk-POPQ4Y6H-OSXerjxo.js → chunk-POPQ4Y6H-D4Zc7_fI.js} +1 -1
  86. package/web/assets/{chunk-SVP7TREG-4azsKQ7R.js → chunk-SVP7TREG-DiJC9xJx.js} +1 -1
  87. package/web/assets/{chunk-XXDRQBXY-RCyyudHN.js → chunk-XXDRQBXY-BhYPRykj.js} +1 -1
  88. package/web/assets/{chunk-ZLD2IHE6-CE_CQEwa.js → chunk-ZLD2IHE6-Cc-O9KsT.js} +1 -1
  89. package/web/assets/classDiagram-CYGNFDIV-IKe_y23-.js +1 -0
  90. package/web/assets/classDiagram-v2-TLXNO2FR-IKe_y23-.js +1 -0
  91. package/web/assets/{conversation-history-CUVjobW9.js → conversation-history-DsSE1wLH.js} +1 -1
  92. package/web/assets/{cose-bilkent-JH36ORCC-B4UTqEAs.js → cose-bilkent-JH36ORCC-rFqp0SYn.js} +1 -1
  93. package/web/assets/{cynefin-OW5HDTMX-B9U7i_AE.js → cynefin-OW5HDTMX-deO0LWKC.js} +1 -1
  94. package/web/assets/{cynefinDiagram-5FMLGOSQ-DjOvM95v.js → cynefinDiagram-5FMLGOSQ-BCj0mYAO.js} +1 -1
  95. package/web/assets/{dagre-OS7QT2EB-DC57hRv_.js → dagre-OS7QT2EB-faTq17DR.js} +1 -1
  96. package/web/assets/{diagram-S7CK7UJ4-D6mHX9Fx.js → diagram-S7CK7UJ4-cAbTZ8qd.js} +1 -1
  97. package/web/assets/{diagram-UQ7AKVKN-B2kIa0Jp.js → diagram-UQ7AKVKN-CxoALt7V.js} +1 -1
  98. package/web/assets/{diagram-VSXAHHWV-Bxv36NlF.js → diagram-VSXAHHWV-BcZM5S7Z.js} +1 -1
  99. package/web/assets/{diagram-VX7I27RA-xZ_Rnq6j.js → diagram-VX7I27RA-QIaSkKCU.js} +1 -1
  100. package/web/assets/{diagram-Z3DM3KII-CdSuHCfk.js → diagram-Z3DM3KII-tYE8PEsy.js} +1 -1
  101. package/web/assets/{ebnfDiagram-PWID7BFC-yx8cKpo-.js → ebnfDiagram-PWID7BFC-CQON9X8w.js} +1 -1
  102. package/web/assets/{el-alert-YwFfkzFY.js → el-alert-DQT74Z6k.js} +1 -1
  103. package/web/assets/{el-cascader-DLHPkFf2.js → el-cascader-B52hB1X4.js} +1 -1
  104. package/web/assets/{el-checkbox-D7B8QPnv.js → el-checkbox-D8E82IC3.js} +1 -1
  105. package/web/assets/{el-date-picker-3YbpvR4-.js → el-date-picker-CzlIv3iG.js} +1 -1
  106. package/web/assets/{el-descriptions-pbjjg_nj.js → el-descriptions-CrLOiLtM.js} +1 -1
  107. package/web/assets/{el-form-item-C0hI6zRh.js → el-form-item-CjLvz7IR.js} +1 -1
  108. package/web/assets/{el-input-BBSbjFbs.js → el-input-DsD8wPgd.js} +1 -1
  109. package/web/assets/{el-input-number-BD9kOXXp.js → el-input-number-DYTEBnhp.js} +1 -1
  110. package/web/assets/{el-radio-ByQM3NKI.js → el-radio-rHorotS0.js} +1 -1
  111. package/web/assets/{el-select-BEIvaLbl.js → el-select-vQRSFUuU.js} +1 -1
  112. package/web/assets/{el-switch-DNSjKrx8.js → el-switch-D49n4nYq.js} +1 -1
  113. package/web/assets/{el-tab-pane-P1W8N6RB.js → el-tab-pane-CpoewUFm.js} +1 -1
  114. package/web/assets/{el-table-column-BkxhVRss.js → el-table-column-DIe-Jdox.js} +1 -1
  115. package/web/assets/{enterprise-management-service-C_5GRorU.js → enterprise-management-service-CYSkSkqU.js} +1 -1
  116. package/web/assets/{erDiagram-2YWLMYGG-CysMQY_a.js → erDiagram-2YWLMYGG-D6cLXjx4.js} +1 -1
  117. package/web/assets/{error-presentation-CMcHjWH1.js → error-presentation-CKm32JzU.js} +1 -1
  118. package/web/assets/{flowDiagram-T62WH6J4-D3EWUl6L.js → flowDiagram-T62WH6J4-CWSvQfIj.js} +1 -1
  119. package/web/assets/{ganttDiagram-EL5Y4UJY-D8p3UoZQ.js → ganttDiagram-EL5Y4UJY-Bk9PlmQ0.js} +1 -1
  120. package/web/assets/{gitGraphDiagram-WWUBYQGX-DOStzbFz.js → gitGraphDiagram-WWUBYQGX-JFxyzn2J.js} +1 -1
  121. package/web/assets/{hosted-conversation-template-client-D4Wn8q89.js → hosted-conversation-template-client-CYBI7IvT.js} +1 -1
  122. package/web/assets/{index-D8dMhcz9.js → index-98DLRplS.js} +1 -1
  123. package/web/assets/{index-DkfdzgTk.js → index-BP-OH85t.js} +1 -1
  124. package/web/assets/{index-CM_0TkoS.js → index-BQ4D3lnr.js} +1 -1
  125. package/web/assets/{index-bl_S7WPN.js → index-BS-OsBk1.js} +1 -1
  126. package/web/assets/{index-DbuM3bO4.js → index-BTXpkf3M.js} +1 -1
  127. package/web/assets/{index-DLalpHzD.js → index-BbOzeZis.js} +1 -1
  128. package/web/assets/{index-m9YdF02w.js → index-BzBol34B.js} +1 -1
  129. package/web/assets/{index-DW6tcz5Z.js → index-C-rtGAiQ.js} +1 -1
  130. package/web/assets/{index-CYeXhiRu.js → index-C20Ctqox.js} +1 -1
  131. package/web/assets/{index-BwULrRvu.js → index-C20z2yeK.js} +1 -1
  132. package/web/assets/{index-0Qtks3Zu.js → index-C38uEGP7.js} +1 -1
  133. package/web/assets/{index-DuKtBO_u.js → index-C8HJ-7wK.js} +1 -1
  134. package/web/assets/{index-CwiFFfS1.js → index-CNYQPSEc.js} +1 -1
  135. package/web/assets/{index-BLspLxxD.js → index-CRCrq0fK.js} +1 -1
  136. package/web/assets/{index-nTguJepi.js → index-CeewrlMR.js} +1 -1
  137. package/web/assets/{index-C4XljgeB.js → index-D0gqeuOi.js} +1 -1
  138. package/web/assets/{index-Df8FjIGd.js → index-DCX6wtGf.js} +1 -1
  139. package/web/assets/{index-DswoMecP.js → index-DFYUX44y.js} +1 -1
  140. package/web/assets/{index-CGPHfg1G.js → index-DYEKyod1.js} +1 -1
  141. package/web/assets/{index-DrVPbxCP.js → index-Dmjcd9dH.js} +1 -1
  142. package/web/assets/{index-B35Hh-19.js → index-DqPiRdTW.js} +1 -1
  143. package/web/assets/{index-CvclBhn2.js → index-Dw3xGHpw.js} +1 -1
  144. package/web/assets/{index-B26xf70t.js → index-FxdcMPQK.js} +1 -1
  145. package/web/assets/{index-ft9uuHSX.js → index-GDJZ4nKF.js} +1 -1
  146. package/web/assets/{index-CiC8263F.js → index-QkybH-4Y.js} +1 -1
  147. package/web/assets/{index-dMLXuty7.js → index-X_ZLsJF-.js} +1 -1
  148. package/web/assets/{index-DTE-qCKl.js → index-oJjFup0f.js} +1 -1
  149. package/web/assets/{index-eJcmffyl.js → index-s_IiIj3Q.js} +1 -1
  150. package/web/assets/{index-BCZqekVb.js → index-tebwt16R.js} +3 -3
  151. package/web/assets/infoDiagram-FKFFQAWI-odw5ek8A.js +2 -0
  152. package/web/assets/{isArrayLikeObject-DBTZh06Y.js → isArrayLikeObject-CNIeaAGq.js} +1 -1
  153. package/web/assets/{ishikawaDiagram-5VMMS53U-KdtSHy0d.js → ishikawaDiagram-5VMMS53U-S3I395rk.js} +1 -1
  154. package/web/assets/{journeyDiagram-EYS64GPL-BWm62hPR.js → journeyDiagram-EYS64GPL-CEURtMQT.js} +1 -1
  155. package/web/assets/{kanban-definition-UXKFOSKX-97_o1WCj.js → kanban-definition-UXKFOSKX-B_I_ageX.js} +1 -1
  156. package/web/assets/{layout-6_PY2p7c.js → layout-C28pcZJ3.js} +1 -1
  157. package/web/assets/{linear-BT7Hx9AK.js → linear-B5pI1vN0.js} +1 -1
  158. package/web/assets/{management-url-service-B2_kg7lH.js → management-url-service-BUrqsIPf.js} +1 -1
  159. package/web/assets/{mcp-center-service-Cvb3tmP2.js → mcp-center-service-Bt8KNvBQ.js} +1 -1
  160. package/web/assets/{merge-DaI_T8rv.js → merge-k_TKlNxw.js} +1 -1
  161. package/web/assets/{mermaid.core-DL0NmHpa.js → mermaid.core-DPF_lBS3.js} +5 -5
  162. package/web/assets/{message-box-service-Vs92kolE.js → message-box-service-BzqjQhzH.js} +1 -1
  163. package/web/assets/{mindmap-definition-THT77NOG-CAPKaXNd.js → mindmap-definition-THT77NOG-D1wx2rOh.js} +1 -1
  164. package/web/assets/{mobile-dialog-return-service-3QafxIkr.js → mobile-dialog-return-service-CDghLsut.js} +1 -1
  165. package/web/assets/{oauth-callback-BlSeaEf-.js → oauth-callback-B21gNkv-.js} +1 -1
  166. package/web/assets/{pegDiagram-XKGWAZYB-hJB71Znn.js → pegDiagram-XKGWAZYB-0meuEp8g.js} +1 -1
  167. package/web/assets/{pieDiagram-E7YTZNPT-COeAYSnz.js → pieDiagram-E7YTZNPT-jC3klXwe.js} +1 -1
  168. package/web/assets/{quadrantDiagram-AXDQQJYC-DHTuVvw3.js → quadrantDiagram-AXDQQJYC-DzQbzknx.js} +1 -1
  169. package/web/assets/{railroadDiagram-O6MQD6OU-bKHrlAIG.js → railroadDiagram-O6MQD6OU-DwiX_44I.js} +1 -1
  170. package/web/assets/{requirementDiagram-IS5BZ75X--2VkiRxe.js → requirementDiagram-IS5BZ75X-DdBB28Xn.js} +1 -1
  171. package/web/assets/{runner-presentation-BW-vKSQP.js → runner-presentation-CjPY5Dey.js} +1 -1
  172. package/web/assets/{sankeyDiagram-P5KCCOFB-k5g8_UfF.js → sankeyDiagram-P5KCCOFB-B1WX3WR_.js} +1 -1
  173. package/web/assets/{sequenceDiagram-WJ2MYXX4-3T1cTiKX.js → sequenceDiagram-WJ2MYXX4-Cz_KunCM.js} +1 -1
  174. package/web/assets/{session-share-client-service-BePcCd8T.js → session-share-client-service-C-0DdFRE.js} +1 -1
  175. package/web/assets/{sizeCapture-INFHLROL-CAmN45ar.js → sizeCapture-INFHLROL-sB2YOfNo.js} +1 -1
  176. package/web/assets/{stateDiagram-XQSTLZYL-DyCNMKfm.js → stateDiagram-XQSTLZYL-Bwb7A16z.js} +1 -1
  177. package/web/assets/stateDiagram-v2-IH3M54BS-DY5Ukxza.js +1 -0
  178. package/web/assets/{swimlanes-V6O3JKXN-CShGr_U7.js → swimlanes-V6O3JKXN-BNtAnq9r.js} +1 -1
  179. package/web/assets/swimlanesDiagram-JKAHXJPX-BZu5MiNn.js +8 -0
  180. package/web/assets/{time-presentation-DYGS-swy.js → time-presentation-Cz63DSUv.js} +1 -1
  181. package/web/assets/{timeline-definition-24CTP7MA-CRagiyPI.js → timeline-definition-24CTP7MA-Cs6NtxYd.js} +1 -1
  182. package/web/assets/{union-SQqiJk16.js → union-C5QcR3bq.js} +1 -1
  183. package/web/assets/{use-form-common-props-CiMdMq_M.js → use-form-common-props-C_muwpbj.js} +1 -1
  184. package/web/assets/{use-wheel-BGpTGiSt.js → use-wheel-7n7Aiy_e.js} +1 -1
  185. package/web/assets/{vennDiagram-4TSXK5OY-_jtB4CJn.js → vennDiagram-4TSXK5OY-DQcN4PIp.js} +1 -1
  186. package/web/assets/{wardleyDiagram-VM6X3IG4-Blsdb7g_.js → wardleyDiagram-VM6X3IG4-B5qQJgni.js} +1 -1
  187. package/web/assets/{workbench-composer-interaction-controller-BvnJG4HW.js → workbench-composer-interaction-controller-BFZkEbwV.js} +19 -19
  188. package/web/assets/{workbench-presentation-b_MlZ-jq.js → workbench-presentation-DSjYJkKK.js} +1 -1
  189. package/web/assets/{xychartDiagram-S5SC5T6Z-BTu61LZj.js → xychartDiagram-S5SC5T6Z-B8yJLdGw.js} +1 -1
  190. package/web/docs/404.html +2 -2
  191. package/web/docs/administration/account.html +4 -4
  192. package/web/docs/administration/audit.html +4 -4
  193. package/web/docs/administration/conversation-templates.html +4 -4
  194. package/web/docs/administration/email-notifications.html +4 -4
  195. package/web/docs/administration/license.html +5 -5
  196. package/web/docs/administration/nodes-workspaces.html +4 -4
  197. package/web/docs/administration/oauth.html +4 -4
  198. package/web/docs/administration/secrets.html +4 -4
  199. package/web/docs/administration/template-workspace-maintenance.html +4 -4
  200. package/web/docs/administration/users-organizations.html +4 -4
  201. package/web/docs/assets/administration_license.md.CVLEsGB6.js +1 -0
  202. package/web/docs/assets/{administration_license.md.CdgtKnVd.lean.js → administration_license.md.CVLEsGB6.lean.js} +1 -1
  203. package/web/docs/assets/{app.DQ73g8Ca.js → app.HBmL36pQ.js} +1 -1
  204. package/web/docs/assets/chunks/@localSearchIndexen-US.pxMPDJyo.js +1 -0
  205. package/web/docs/assets/chunks/@localSearchIndexroot.Bmvw1ncU.js +1 -0
  206. package/web/docs/assets/chunks/{VPLocalSearchBox.vP8fXe46.js → VPLocalSearchBox.9e8uHIOt.js} +1 -1
  207. package/web/docs/assets/chunks/{theme.CES2lSYr.js → theme.CXF2ox30.js} +2 -2
  208. package/web/docs/assets/deployment_network.md.Bbi7-zH2.js +1 -0
  209. package/web/docs/assets/deployment_network.md.Bbi7-zH2.lean.js +1 -0
  210. package/web/docs/assets/deployment_upgrade.md.CG_VFxvG.js +1 -0
  211. package/web/docs/assets/deployment_upgrade.md.CG_VFxvG.lean.js +1 -0
  212. package/web/docs/assets/{en-US_administration_license.md.jmAMVJjC.js → en-US_administration_license.md.GCAYq1LT.js} +1 -1
  213. package/web/docs/assets/{en-US_administration_license.md.jmAMVJjC.lean.js → en-US_administration_license.md.GCAYq1LT.lean.js} +1 -1
  214. package/web/docs/assets/en-US_deployment_network.md.770EzfaT.js +1 -0
  215. package/web/docs/assets/en-US_deployment_network.md.770EzfaT.lean.js +1 -0
  216. package/web/docs/assets/en-US_deployment_upgrade.md.DDevql7U.js +1 -0
  217. package/web/docs/assets/{en-US_deployment_upgrade.md.DZiDDiLn.lean.js → en-US_deployment_upgrade.md.DDevql7U.lean.js} +1 -1
  218. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.D46Ec15e.js +3 -0
  219. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.D46Ec15e.lean.js +1 -0
  220. package/web/docs/assets/{en-US_getting-started_overview.md.Bug5sh21.js → en-US_getting-started_overview.md.CB-43rGR.js} +1 -1
  221. package/web/docs/assets/{en-US_getting-started_overview.md.Bug5sh21.lean.js → en-US_getting-started_overview.md.CB-43rGR.lean.js} +1 -1
  222. package/web/docs/assets/en-US_getting-started_prerequisites.md.BFxGOlUy.js +1 -0
  223. package/web/docs/assets/en-US_getting-started_prerequisites.md.BFxGOlUy.lean.js +1 -0
  224. package/web/docs/assets/{en-US_getting-started_server-installation.md._k2XGM85.js → en-US_getting-started_server-installation.md.C7SjGDJt.js} +2 -2
  225. package/web/docs/assets/en-US_workbench_skills.md.xchi27R9.js +1 -0
  226. package/web/docs/assets/{en-US_workbench_skills.md.C4xlXyjC.lean.js → en-US_workbench_skills.md.xchi27R9.lean.js} +1 -1
  227. package/web/docs/assets/getting-started_npm-quick-start.md.CIYjFmiu.js +3 -0
  228. package/web/docs/assets/getting-started_npm-quick-start.md.CIYjFmiu.lean.js +1 -0
  229. package/web/docs/assets/{getting-started_overview.md.CA1CCOBc.js → getting-started_overview.md.Cv-HSfAh.js} +1 -1
  230. package/web/docs/assets/getting-started_prerequisites.md.DjWWTA7V.js +1 -0
  231. package/web/docs/assets/{getting-started_prerequisites.md.D26KU42D.lean.js → getting-started_prerequisites.md.DjWWTA7V.lean.js} +1 -1
  232. package/web/docs/assets/{getting-started_server-installation.md.D3P3Lmc2.js → getting-started_server-installation.md.BsEfVH6b.js} +2 -2
  233. package/web/docs/assets/workbench_skills.md.BQw1Wuiy.js +1 -0
  234. package/web/docs/assets/{workbench_skills.md.rWZ_VuoB.lean.js → workbench_skills.md.BQw1Wuiy.lean.js} +1 -1
  235. package/web/docs/concepts/architecture.html +4 -4
  236. package/web/docs/concepts/data-and-security.html +4 -4
  237. package/web/docs/concepts/files-git-terminal.html +4 -4
  238. package/web/docs/concepts/node-and-workspace.html +4 -4
  239. package/web/docs/concepts/permissions-and-sharing.html +4 -4
  240. package/web/docs/concepts/runner-control.html +4 -4
  241. package/web/docs/concepts/secrets.html +4 -4
  242. package/web/docs/concepts/session-run-turn.html +4 -4
  243. package/web/docs/deployment/backup-restore.html +4 -4
  244. package/web/docs/deployment/network.html +5 -5
  245. package/web/docs/deployment/node-installation.html +4 -4
  246. package/web/docs/deployment/node-linux.html +4 -4
  247. package/web/docs/deployment/node-macos.html +4 -4
  248. package/web/docs/deployment/node-windows.html +4 -4
  249. package/web/docs/deployment/production.html +4 -4
  250. package/web/docs/deployment/security-checklist.html +4 -4
  251. package/web/docs/deployment/upgrade.html +5 -5
  252. package/web/docs/en-US/administration/account.html +4 -4
  253. package/web/docs/en-US/administration/audit.html +4 -4
  254. package/web/docs/en-US/administration/conversation-templates.html +4 -4
  255. package/web/docs/en-US/administration/email-notifications.html +4 -4
  256. package/web/docs/en-US/administration/license.html +5 -5
  257. package/web/docs/en-US/administration/nodes-workspaces.html +4 -4
  258. package/web/docs/en-US/administration/oauth.html +4 -4
  259. package/web/docs/en-US/administration/secrets.html +4 -4
  260. package/web/docs/en-US/administration/template-workspace-maintenance.html +4 -4
  261. package/web/docs/en-US/administration/users-organizations.html +4 -4
  262. package/web/docs/en-US/concepts/architecture.html +4 -4
  263. package/web/docs/en-US/concepts/data-and-security.html +4 -4
  264. package/web/docs/en-US/concepts/files-git-terminal.html +4 -4
  265. package/web/docs/en-US/concepts/node-and-workspace.html +4 -4
  266. package/web/docs/en-US/concepts/permissions-and-sharing.html +4 -4
  267. package/web/docs/en-US/concepts/runner-control.html +4 -4
  268. package/web/docs/en-US/concepts/secrets.html +4 -4
  269. package/web/docs/en-US/concepts/session-run-turn.html +4 -4
  270. package/web/docs/en-US/deployment/backup-restore.html +4 -4
  271. package/web/docs/en-US/deployment/network.html +5 -5
  272. package/web/docs/en-US/deployment/node-installation.html +4 -4
  273. package/web/docs/en-US/deployment/node-linux.html +4 -4
  274. package/web/docs/en-US/deployment/node-macos.html +4 -4
  275. package/web/docs/en-US/deployment/node-windows.html +4 -4
  276. package/web/docs/en-US/deployment/production.html +4 -4
  277. package/web/docs/en-US/deployment/security-checklist.html +4 -4
  278. package/web/docs/en-US/deployment/upgrade.html +5 -5
  279. package/web/docs/en-US/getting-started/connect-node.html +4 -4
  280. package/web/docs/en-US/getting-started/first-agent-session.html +4 -4
  281. package/web/docs/en-US/getting-started/first-login.html +4 -4
  282. package/web/docs/en-US/getting-started/next-steps.html +4 -4
  283. package/web/docs/en-US/getting-started/npm-quick-start.html +7 -7
  284. package/web/docs/en-US/getting-started/overview.html +5 -5
  285. package/web/docs/en-US/getting-started/prerequisites.html +5 -5
  286. package/web/docs/en-US/getting-started/register-workspace.html +4 -4
  287. package/web/docs/en-US/getting-started/server-installation.html +6 -6
  288. package/web/docs/en-US/operations/marctl.html +4 -4
  289. package/web/docs/en-US/reference/configuration.html +4 -4
  290. package/web/docs/en-US/reference/keyboard-shortcuts.html +4 -4
  291. package/web/docs/en-US/reference/limits.html +4 -4
  292. package/web/docs/en-US/reference/ports-paths-data.html +4 -4
  293. package/web/docs/en-US/reference/status-and-errors.html +4 -4
  294. package/web/docs/en-US/runners/claude-code.html +4 -4
  295. package/web/docs/en-US/runners/codex.html +4 -4
  296. package/web/docs/en-US/runners/mar-agent.html +4 -4
  297. package/web/docs/en-US/runners/opencode.html +4 -4
  298. package/web/docs/en-US/runners/overview.html +4 -4
  299. package/web/docs/en-US/runners/runner-troubleshooting.html +4 -4
  300. package/web/docs/en-US/troubleshooting/node-offline.html +4 -4
  301. package/web/docs/en-US/troubleshooting/quick-diagnosis.html +4 -4
  302. package/web/docs/en-US/troubleshooting/session-run.html +4 -4
  303. package/web/docs/en-US/troubleshooting/terminal.html +4 -4
  304. package/web/docs/en-US/troubleshooting/workspace-files.html +4 -4
  305. package/web/docs/en-US/workbench/composer.html +4 -4
  306. package/web/docs/en-US/workbench/context-and-plan.html +4 -4
  307. package/web/docs/en-US/workbench/conversation.html +4 -4
  308. package/web/docs/en-US/workbench/file-reference-and-attachment.html +4 -4
  309. package/web/docs/en-US/workbench/files.html +4 -4
  310. package/web/docs/en-US/workbench/git-changes.html +4 -4
  311. package/web/docs/en-US/workbench/git-history.html +4 -4
  312. package/web/docs/en-US/workbench/hosted-conversations.html +4 -4
  313. package/web/docs/en-US/workbench/mobile.html +4 -4
  314. package/web/docs/en-US/workbench/navigation.html +4 -4
  315. package/web/docs/en-US/workbench/sessions.html +4 -4
  316. package/web/docs/en-US/workbench/skills.html +5 -5
  317. package/web/docs/en-US/workbench/terminal.html +4 -4
  318. package/web/docs/getting-started/connect-node.html +4 -4
  319. package/web/docs/getting-started/first-agent-session.html +4 -4
  320. package/web/docs/getting-started/first-login.html +4 -4
  321. package/web/docs/getting-started/next-steps.html +4 -4
  322. package/web/docs/getting-started/npm-quick-start.html +7 -7
  323. package/web/docs/getting-started/overview.html +5 -5
  324. package/web/docs/getting-started/prerequisites.html +5 -5
  325. package/web/docs/getting-started/register-workspace.html +4 -4
  326. package/web/docs/getting-started/server-installation.html +6 -6
  327. package/web/docs/hashmap.json +1 -1
  328. package/web/docs/operations/marctl.html +4 -4
  329. package/web/docs/reference/configuration.html +4 -4
  330. package/web/docs/reference/keyboard-shortcuts.html +4 -4
  331. package/web/docs/reference/limits.html +4 -4
  332. package/web/docs/reference/ports-paths-data.html +4 -4
  333. package/web/docs/reference/status-and-errors.html +4 -4
  334. package/web/docs/runners/claude-code.html +4 -4
  335. package/web/docs/runners/codex.html +4 -4
  336. package/web/docs/runners/mar-agent.html +4 -4
  337. package/web/docs/runners/opencode.html +4 -4
  338. package/web/docs/runners/overview.html +4 -4
  339. package/web/docs/runners/runner-troubleshooting.html +4 -4
  340. package/web/docs/troubleshooting/node-offline.html +4 -4
  341. package/web/docs/troubleshooting/quick-diagnosis.html +4 -4
  342. package/web/docs/troubleshooting/session-run.html +4 -4
  343. package/web/docs/troubleshooting/terminal.html +4 -4
  344. package/web/docs/troubleshooting/workspace-files.html +4 -4
  345. package/web/docs/workbench/composer.html +4 -4
  346. package/web/docs/workbench/context-and-plan.html +4 -4
  347. package/web/docs/workbench/conversation.html +4 -4
  348. package/web/docs/workbench/file-reference-and-attachment.html +4 -4
  349. package/web/docs/workbench/files.html +4 -4
  350. package/web/docs/workbench/git-changes.html +4 -4
  351. package/web/docs/workbench/git-history.html +4 -4
  352. package/web/docs/workbench/hosted-conversations.html +4 -4
  353. package/web/docs/workbench/mobile.html +4 -4
  354. package/web/docs/workbench/navigation.html +4 -4
  355. package/web/docs/workbench/sessions.html +4 -4
  356. package/web/docs/workbench/skills.html +5 -5
  357. package/web/docs/workbench/terminal.html +4 -4
  358. package/web/index.html +1 -1
  359. package/web/service-worker.js +1 -1
  360. package/web/web-version.json +1 -1
  361. package/web/assets/HtmlPreviewFrame-ClcGdqP1.js +0 -5
  362. package/web/assets/NodeManagementPage-8rxZ_6Zt.js +0 -1
  363. package/web/assets/NodeManagementPage-Ccod7oYU.js +0 -1
  364. package/web/assets/SecretManagementPage-CdgTv3Ov.js +0 -1
  365. package/web/assets/SkillCenterPage-93Mc7S1A.js +0 -1
  366. package/web/assets/SystemConfigurationPage-Dg5txhny.js +0 -1
  367. package/web/assets/WorkbenchPage-C1l73Bo7.css +0 -1
  368. package/web/assets/WorkspaceManagementPage-D_xOZ93I.js +0 -1
  369. package/web/assets/WorkspaceManagementPage-K7-IdW3A.js +0 -1
  370. package/web/assets/channel-Df00MEsi.js +0 -1
  371. package/web/assets/classDiagram-CYGNFDIV-BkPukKVs.js +0 -1
  372. package/web/assets/classDiagram-v2-TLXNO2FR-BkPukKVs.js +0 -1
  373. package/web/assets/infoDiagram-FKFFQAWI-DMowyzbG.js +0 -2
  374. package/web/assets/stateDiagram-v2-IH3M54BS-BEZ0_9G2.js +0 -1
  375. package/web/assets/swimlanesDiagram-JKAHXJPX-2keKlibd.js +0 -8
  376. package/web/docs/assets/administration_license.md.CdgtKnVd.js +0 -1
  377. package/web/docs/assets/chunks/@localSearchIndexen-US.BmMs0yM1.js +0 -1
  378. package/web/docs/assets/chunks/@localSearchIndexroot.BUqMaw8-.js +0 -1
  379. package/web/docs/assets/deployment_network.md.BarghfLt.js +0 -1
  380. package/web/docs/assets/deployment_network.md.BarghfLt.lean.js +0 -1
  381. package/web/docs/assets/deployment_upgrade.md.BESOToM5.js +0 -1
  382. package/web/docs/assets/deployment_upgrade.md.BESOToM5.lean.js +0 -1
  383. package/web/docs/assets/en-US_deployment_network.md.DdOgOLns.js +0 -1
  384. package/web/docs/assets/en-US_deployment_network.md.DdOgOLns.lean.js +0 -1
  385. package/web/docs/assets/en-US_deployment_upgrade.md.DZiDDiLn.js +0 -1
  386. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.CLCHq7k_.js +0 -3
  387. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.CLCHq7k_.lean.js +0 -1
  388. package/web/docs/assets/en-US_getting-started_prerequisites.md.Bpx_AQD1.js +0 -1
  389. package/web/docs/assets/en-US_getting-started_prerequisites.md.Bpx_AQD1.lean.js +0 -1
  390. package/web/docs/assets/en-US_workbench_skills.md.C4xlXyjC.js +0 -1
  391. package/web/docs/assets/getting-started_npm-quick-start.md.B9varoSe.js +0 -3
  392. package/web/docs/assets/getting-started_npm-quick-start.md.B9varoSe.lean.js +0 -1
  393. package/web/docs/assets/getting-started_prerequisites.md.D26KU42D.js +0 -1
  394. package/web/docs/assets/workbench_skills.md.rWZ_VuoB.js +0 -1
  395. /package/web/docs/assets/{en-US_getting-started_server-installation.md._k2XGM85.lean.js → en-US_getting-started_server-installation.md.C7SjGDJt.lean.js} +0 -0
  396. /package/web/docs/assets/{getting-started_overview.md.CA1CCOBc.lean.js → getting-started_overview.md.Cv-HSfAh.lean.js} +0 -0
  397. /package/web/docs/assets/{getting-started_server-installation.md.D3P3Lmc2.lean.js → getting-started_server-installation.md.BsEfVH6b.lean.js} +0 -0
package/web/docs/en-US/deployment/node-installation.html CHANGED
@@ -9,16 +9,16 @@
9
9
  <link rel="preload stylesheet" href="/docs/assets/style.B3QdEOQQ.css" as="style">
10
10
  <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/docs/assets/app.DQ73g8Ca.js"></script>
12
+ <script type="module" src="/docs/assets/app.HBmL36pQ.js"></script>
13
13
  <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/docs/assets/chunks/theme.CES2lSYr.js">
14
+ <link rel="modulepreload" href="/docs/assets/chunks/theme.CXF2ox30.js">
15
15
  <link rel="modulepreload" href="/docs/assets/chunks/framework.BHjrhdiC.js">
16
16
  <link rel="modulepreload" href="/docs/assets/en-US_deployment_node-installation.md.DDQ4RdWI.lean.js">
17
17
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
18
18
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
19
19
  </head>
20
20
  <body>
21
- <div id="app"><div class="Layout" data-v-ef19ba22><!--[--><!--]--><!--[--><span tabindex="-1" data-v-bbc8ff95></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-bbc8ff95>Skip to content</a><!--]--><!----><header class="VPNav" data-v-ef19ba22 data-v-974a37fc><div class="VPNavBar" data-v-974a37fc data-v-94126289><div class="wrapper" data-v-94126289><div class="container" data-v-94126289><div class="title" data-v-94126289><div class="VPNavBarTitle has-sidebar" data-v-94126289 data-v-52450919><a class="title" href="/" data-v-52450919><!--[--><!--]--><!--[--><img class="VPImage logo" src="/docs/logo.png?v=logo-20261011" alt data-v-dd4a1533><!--]--><span data-v-52450919>Documentation</span><!--[--><!--]--></a></div></div><div class="content" data-v-94126289><div class="content-body" data-v-94126289><!--[--><!--]--><div class="VPNavBarSearch search" data-v-94126289><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search Documentation"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search Documentation</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><!----><div class="VPFlyout VPNavBarTranslations translations" data-v-94126289 data-v-7547c9e2 data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="Switch language" data-v-5d7cf148><span class="text" data-v-5d7cf148><span class="vpi-languages option-icon" data-v-5d7cf148></span><!----><span class="vpi-chevron-down text-icon" data-v-5d7cf148></span></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="items" data-v-7547c9e2><p class="title" data-v-7547c9e2>English</p><!--[--><div class="VPMenuLink" data-v-7547c9e2 data-v-d62fa8e2><a class="VPLink link" href="/docs/deployment/node-installation" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>简体中文</span><!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-94126289 data-v-b81617e7><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-b81617e7 data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-94126289 data-v-0e59b9da data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d7cf148><span class="vpi-more-horizontal icon" data-v-5d7cf148></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="group translations" data-v-0e59b9da><p class="trans-title" data-v-0e59b9da>English</p><!--[--><div class="VPMenuLink" data-v-0e59b9da data-v-d62fa8e2><a class="VPLink link" href="/docs/deployment/node-installation" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>简体中文</span><!--]--></a></div><!--]--></div><div class="group" data-v-0e59b9da><div class="item appearance" data-v-0e59b9da><p class="label" data-v-0e59b9da>Appearance</p><div class="appearance-action" data-v-0e59b9da><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0e59b9da data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--[--><!--[--><div class="docs-desktop-actions"><a class="docs-console-link" href="/console" target="_self">Console</a></div><!--]--><!--]--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-94126289 data-v-f8aa66a1><span class="container" data-v-f8aa66a1><span class="top" data-v-f8aa66a1></span><span class="middle" data-v-f8aa66a1></span><span class="bottom" data-v-f8aa66a1></span></span></button></div></div></div></div><div class="divider" data-v-94126289><div class="divider-line" data-v-94126289></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-ef19ba22 data-v-0f137e95><div class="container" data-v-0f137e95><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-0f137e95><span class="vpi-align-left menu-icon" data-v-0f137e95></span><span class="menu-text" data-v-0f137e95>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-0f137e95 data-v-8da33559><button data-v-8da33559>Return to Top</button><!----></div></div></div><aside class="VPSidebar" data-v-ef19ba22 data-v-25c855a9><div class="curtain" data-v-25c855a9></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-25c855a9><span class="visually-hidden" id="sidebar-aria-label" data-v-25c855a9> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Getting Started</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>What Is MyAgentRoam?</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/npm-quick-start" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Local npm Quick Start</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/prerequisites" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Before You Deploy</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/server-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Deploy Server and Web</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/first-login" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>First Sign-in and Password Change</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/connect-node" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Connect Your First Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/register-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Register Your First Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/first-agent-session" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Start Your First Agent Session</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/next-steps" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Next Steps</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Core Concepts</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/architecture" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Server, Node, Web, and Runner</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/node-and-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Nodes and Workspaces</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/session-run-turn" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Sessions, Runs, and Message Queues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/runner-control" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Runners and Session Control</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/files-git-terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Files, Git, and Terminals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/permissions-and-sharing" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Users, Organizations, and Access</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Secrets and Injection Order</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/data-and-security" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Data, Credentials, and Security</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Work / Conversation Guide</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/navigation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Work Mode, Nodes, and Workspaces</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/skills" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Favorite and Install Skills</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/sessions" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Create and Manage Sessions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/composer" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Messages and Composer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/context-and-plan" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Context, Compact, and Plan</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/file-reference-and-attachment" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>References, Folders, and Attachments</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/conversation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Conversations, Tools, and Notifications</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/hosted-conversations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Start a Template Conversation in Conversation Mode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Browse, Search, and Manage Files</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/git-changes" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Git Changes and Diff</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/git-history" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Git History</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Workspace Terminals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/mobile" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Continue on Mobile</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Agent Guide</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Choose an Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/opencode" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>OpenCode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/codex" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Codex</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/claude-code" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Claude Code</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/mar-agent" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Built-in MAR Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/runner-troubleshooting" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Runner Troubleshooting</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0 has-active" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Deployment and Operations</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/production" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Production Deployment and Reverse Proxy</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Install and Register a Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-linux" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Linux Node and systemd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-windows" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Windows Node and Task Scheduler</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-macos" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>macOS Node and launchd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/upgrade" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Upgrade MyAgentRoam</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/backup-restore" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Backup and Restore</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/network" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Network, TLS, and WebSocket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/security-checklist" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Production Security Checklist</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Node Operations Tools</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/operations/marctl" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Nodes with marctl</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Administration Guide</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/account" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Account Security and Sign-in Sessions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/nodes-workspaces" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Nodes and Workspaces</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/conversation-templates" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Conversation Templates</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/template-workspace-maintenance" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Maintain a Conversation Template Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Secrets</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/email-notifications" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Configure SMTP Email and Notification Templates</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/users-organizations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Users, Organizations, and Roles</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/oauth" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Configure OAuth 2.0 SSO</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/audit" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Audit Events and Export</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/license" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Personal and Enterprise Licenses</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Troubleshooting and Reference</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/quick-diagnosis" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Quick Diagnosis</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/node-offline" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Node Registration or Offline Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/workspace-files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Workspace, File, or Git Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/session-run" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Session Stuck or Read-only</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Terminal Connection Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/keyboard-shortcuts" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Keyboard Shortcuts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/status-and-errors" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Statuses and Common Errors</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/configuration" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Configuration Reference</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/ports-paths-data" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Ports, Paths, and Data</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/limits" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Versions, Capacity, and Limits</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-ef19ba22 data-v-8da8809f><div class="VPDoc has-sidebar has-aside" data-v-8da8809f data-v-cd08f8de><!--[--><!--]--><div class="container" data-v-cd08f8de><div class="aside" data-v-cd08f8de><div class="aside-curtain" data-v-cd08f8de></div><div class="aside-container" data-v-cd08f8de><div class="aside-content" data-v-cd08f8de><div class="VPDocAside" data-v-cd08f8de data-v-56ec1007><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-56ec1007 data-v-30a0162a><div class="content" data-v-30a0162a><div class="outline-marker" data-v-30a0162a></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-30a0162a>On This Page</div><ul class="VPDocOutlineItem root" data-v-30a0162a data-v-da64eb8d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-56ec1007></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-cd08f8de><div class="content-container" data-v-cd08f8de><!--[--><!--[--><!--[--><div class="document-meta"><span>Last updated: 2026-10-29</span><button type="button" class="copy-page-button">Copy Page</button></div><!--]--><!--]--><!--]--><main class="main" data-v-cd08f8de><div style="position:relative;" class="vp-doc _docs_en-US_deployment_node-installation" data-v-cd08f8de><div><h1 id="install-and-register-a-node" tabindex="-1">Install and Register a Node <a class="header-anchor" href="#install-and-register-a-node" aria-label="Permalink to &quot;Install and Register a Node&quot;">​</a></h1><p>Only one Node runtime may use a local data directory at a time. A duplicate start exits with <code>NODE_DATA_DIRECTORY_IN_USE</code>. Stop the original instance normally through its service or terminal before starting another; do not delete <code>node-owner.sqlite</code> to bypass ownership. Supervisor stops its internal retry for that duplicate start, but an external service manager may still restart the service according to its own policy.</p><p>Normal restarts and managed upgrades hand over after the old instance exits. An ordinary disconnect does not stop accepted executions, and a replaced control connection does not prove that execution on the old host has ended. Local directory ownership does not fence identities copied to another directory or host; do not copy credentials to bypass a duplicate-instance error.</p><p>Use Node.js <code>&gt;=22.13</code>, an HTTPS Server URL, a dedicated service account, and real Workspace roots writable by that account. Windows, Linux, and macOS work hosts are supported. Hosted conversations require Bubblewrap and run only on Linux Nodes.</p><p>For a first connection, you can use <a href="./../runners/mar-agent">built-in MAR Agent</a> without an external Agent CLI; an administrator configures and authorizes its model. If you use Codex, Claude Code, or OpenCode, install and configure the corresponding CLI under the same service account.</p><ol><li>Confirm <code>commonVersion</code> in the current product release manifest and install that exact <code>@myagentroam/node</code> version. Server/Web, Node, Agent, and Protocol share one version baseline; the manifest&#39;s <code>productVersion</code> and <code>commonVersion</code> must match. Still install the manifest&#39;s exact version, not npm&#39;s floating <code>latest</code>. If the manifest is unavailable, ask the deployment administrator for the exact version. Matching version numbers do not replace protocol and capability compatibility checks.</li><li>In <strong>Admin → Nodes</strong>, create a registration key. Save the key from the separate success dialog before closing it, then set <code>registrationToken</code> in the target Node configuration. The dialog also provides instructions and a deployment guide. Creating a registration key does not connect the Node.</li><li>Create a private configuration containing <code>serverUrl</code>, the token for first registration, <code>dataDirectory</code>, narrowly scoped <code>allowedRoots</code>, and optionally a <code>directTransfer</code> UDP range. The default pool is <code>49152-49215</code>; set the range start and end to the same value when the Node must use one fixed firewall port.</li><li>Restrict the configuration and entire data directory to the service account. They contain Node credentials, SQLite data, and logs; keep them out of npm package directories, Git, and chats.</li><li>Verify in the foreground with <code>mar-node run --config &lt;config-file&gt;</code>, then configure a Supervisor-backed service for production.</li></ol><p>For example, on Linux create a private JSON file, replacing every placeholder with your Server address, service account paths, and one-time registration key:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
21
+ <div id="app"><div class="Layout" data-v-ef19ba22><!--[--><!--]--><!--[--><span tabindex="-1" data-v-bbc8ff95></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-bbc8ff95>Skip to content</a><!--]--><!----><header class="VPNav" data-v-ef19ba22 data-v-974a37fc><div class="VPNavBar" data-v-974a37fc data-v-94126289><div class="wrapper" data-v-94126289><div class="container" data-v-94126289><div class="title" data-v-94126289><div class="VPNavBarTitle has-sidebar" data-v-94126289 data-v-52450919><a class="title" href="/" data-v-52450919><!--[--><!--]--><!--[--><img class="VPImage logo" src="/docs/logo.png?v=logo-20261011" alt data-v-dd4a1533><!--]--><span data-v-52450919>Documentation</span><!--[--><!--]--></a></div></div><div class="content" data-v-94126289><div class="content-body" data-v-94126289><!--[--><!--]--><div class="VPNavBarSearch search" data-v-94126289><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search Documentation"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search Documentation</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><!----><div class="VPFlyout VPNavBarTranslations translations" data-v-94126289 data-v-7547c9e2 data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="Switch language" data-v-5d7cf148><span class="text" data-v-5d7cf148><span class="vpi-languages option-icon" data-v-5d7cf148></span><!----><span class="vpi-chevron-down text-icon" data-v-5d7cf148></span></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="items" data-v-7547c9e2><p class="title" data-v-7547c9e2>English</p><!--[--><div class="VPMenuLink" data-v-7547c9e2 data-v-d62fa8e2><a class="VPLink link" href="/docs/deployment/node-installation" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>简体中文</span><!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-94126289 data-v-b81617e7><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-b81617e7 data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-94126289 data-v-0e59b9da data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d7cf148><span class="vpi-more-horizontal icon" data-v-5d7cf148></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="group translations" data-v-0e59b9da><p class="trans-title" data-v-0e59b9da>English</p><!--[--><div class="VPMenuLink" data-v-0e59b9da data-v-d62fa8e2><a class="VPLink link" href="/docs/deployment/node-installation" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>简体中文</span><!--]--></a></div><!--]--></div><div class="group" data-v-0e59b9da><div class="item appearance" data-v-0e59b9da><p class="label" data-v-0e59b9da>Appearance</p><div class="appearance-action" data-v-0e59b9da><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0e59b9da data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--[--><!--[--><div class="docs-desktop-actions"><a class="docs-console-link" href="/console" target="_self">Console</a></div><!--]--><!--]--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-94126289 data-v-f8aa66a1><span class="container" data-v-f8aa66a1><span class="top" data-v-f8aa66a1></span><span class="middle" data-v-f8aa66a1></span><span class="bottom" data-v-f8aa66a1></span></span></button></div></div></div></div><div class="divider" data-v-94126289><div class="divider-line" data-v-94126289></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-ef19ba22 data-v-0f137e95><div class="container" data-v-0f137e95><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-0f137e95><span class="vpi-align-left menu-icon" data-v-0f137e95></span><span class="menu-text" data-v-0f137e95>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-0f137e95 data-v-8da33559><button data-v-8da33559>Return to Top</button><!----></div></div></div><aside class="VPSidebar" data-v-ef19ba22 data-v-25c855a9><div class="curtain" data-v-25c855a9></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-25c855a9><span class="visually-hidden" id="sidebar-aria-label" data-v-25c855a9> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Getting Started</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>What Is MyAgentRoam?</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/npm-quick-start" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>npm Quick Start</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/prerequisites" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Before You Deploy</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/server-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Deploy Server and Web</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/first-login" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>First Sign-in and Password Change</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/connect-node" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Connect Your First Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/register-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Register Your First Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/first-agent-session" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Start Your First Agent Session</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/getting-started/next-steps" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Next Steps</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Core Concepts</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/architecture" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Server, Node, Web, and Runner</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/node-and-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Nodes and Workspaces</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/session-run-turn" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Sessions, Runs, and Message Queues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/runner-control" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Runners and Session Control</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/files-git-terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Files, Git, and Terminals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/permissions-and-sharing" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Users, Organizations, and Access</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Secrets and Injection Order</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/concepts/data-and-security" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Data, Credentials, and Security</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Work / Conversation Guide</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/navigation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Work Mode, Nodes, and Workspaces</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/skills" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Favorite and Install Skills</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/sessions" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Create and Manage Sessions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/composer" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Messages and Composer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/context-and-plan" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Context, Compact, and Plan</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/file-reference-and-attachment" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>References, Folders, and Attachments</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/conversation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Conversations, Tools, and Notifications</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/hosted-conversations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Start a Template Conversation in Conversation Mode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Browse, Search, and Manage Files</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/git-changes" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Git Changes and Diff</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/git-history" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Git History</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Workspace Terminals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/workbench/mobile" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Continue on Mobile</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Agent Guide</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Choose an Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/opencode" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>OpenCode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/codex" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Codex</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/claude-code" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Claude Code</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/mar-agent" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Built-in MAR Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/runners/runner-troubleshooting" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Runner Troubleshooting</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0 has-active" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Deployment and Operations</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/production" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Production Deployment and Reverse Proxy</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Install and Register a Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-linux" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Linux Node and systemd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-windows" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Windows Node and Task Scheduler</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/node-macos" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>macOS Node and launchd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/upgrade" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Upgrade MyAgentRoam</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/backup-restore" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Backup and Restore</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/network" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Network, TLS, and WebSocket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/deployment/security-checklist" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Production Security Checklist</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Node Operations Tools</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/operations/marctl" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Nodes with marctl</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Administration Guide</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/account" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Account Security and Sign-in Sessions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/nodes-workspaces" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Nodes and Workspaces</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/conversation-templates" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Conversation Templates</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/template-workspace-maintenance" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Maintain a Conversation Template Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Secrets</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/email-notifications" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Configure SMTP Email and Notification Templates</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/users-organizations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Manage Users, Organizations, and Roles</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/oauth" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Configure OAuth 2.0 SSO</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/audit" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Audit Events and Export</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/administration/license" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Personal and Enterprise Licenses</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Troubleshooting and Reference</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/quick-diagnosis" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Quick Diagnosis</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/node-offline" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Node Registration or Offline Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/workspace-files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Workspace, File, or Git Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/session-run" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Session Stuck or Read-only</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/troubleshooting/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Terminal Connection Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/keyboard-shortcuts" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Keyboard Shortcuts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/status-and-errors" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Statuses and Common Errors</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/configuration" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Configuration Reference</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/ports-paths-data" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Ports, Paths, and Data</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/en-US/reference/limits" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Versions, Capacity, and Limits</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-ef19ba22 data-v-8da8809f><div class="VPDoc has-sidebar has-aside" data-v-8da8809f data-v-cd08f8de><!--[--><!--]--><div class="container" data-v-cd08f8de><div class="aside" data-v-cd08f8de><div class="aside-curtain" data-v-cd08f8de></div><div class="aside-container" data-v-cd08f8de><div class="aside-content" data-v-cd08f8de><div class="VPDocAside" data-v-cd08f8de data-v-56ec1007><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-56ec1007 data-v-30a0162a><div class="content" data-v-30a0162a><div class="outline-marker" data-v-30a0162a></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-30a0162a>On This Page</div><ul class="VPDocOutlineItem root" data-v-30a0162a data-v-da64eb8d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-56ec1007></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-cd08f8de><div class="content-container" data-v-cd08f8de><!--[--><!--[--><!--[--><div class="document-meta"><span>Last updated: 2026-10-29</span><button type="button" class="copy-page-button">Copy Page</button></div><!--]--><!--]--><!--]--><main class="main" data-v-cd08f8de><div style="position:relative;" class="vp-doc _docs_en-US_deployment_node-installation" data-v-cd08f8de><div><h1 id="install-and-register-a-node" tabindex="-1">Install and Register a Node <a class="header-anchor" href="#install-and-register-a-node" aria-label="Permalink to &quot;Install and Register a Node&quot;">​</a></h1><p>Only one Node runtime may use a local data directory at a time. A duplicate start exits with <code>NODE_DATA_DIRECTORY_IN_USE</code>. Stop the original instance normally through its service or terminal before starting another; do not delete <code>node-owner.sqlite</code> to bypass ownership. Supervisor stops its internal retry for that duplicate start, but an external service manager may still restart the service according to its own policy.</p><p>Normal restarts and managed upgrades hand over after the old instance exits. An ordinary disconnect does not stop accepted executions, and a replaced control connection does not prove that execution on the old host has ended. Local directory ownership does not fence identities copied to another directory or host; do not copy credentials to bypass a duplicate-instance error.</p><p>Use Node.js <code>&gt;=22.13</code>, an HTTPS Server URL, a dedicated service account, and real Workspace roots writable by that account. Windows, Linux, and macOS work hosts are supported. Hosted conversations require Bubblewrap and run only on Linux Nodes.</p><p>For a first connection, you can use <a href="./../runners/mar-agent">built-in MAR Agent</a> without an external Agent CLI; an administrator configures and authorizes its model. If you use Codex, Claude Code, or OpenCode, install and configure the corresponding CLI under the same service account.</p><ol><li>Confirm <code>commonVersion</code> in the current product release manifest and install that exact <code>@myagentroam/node</code> version. Server/Web, Node, Agent, and Protocol share one version baseline; the manifest&#39;s <code>productVersion</code> and <code>commonVersion</code> must match. Still install the manifest&#39;s exact version, not npm&#39;s floating <code>latest</code>. If the manifest is unavailable, ask the deployment administrator for the exact version. Matching version numbers do not replace protocol and capability compatibility checks.</li><li>In <strong>Admin → Nodes</strong>, create a registration key. Save the key from the separate success dialog before closing it, then set <code>registrationToken</code> in the target Node configuration. The dialog also provides instructions and a deployment guide. Creating a registration key does not connect the Node.</li><li>Create a private configuration containing <code>serverUrl</code>, the token for first registration, <code>dataDirectory</code>, narrowly scoped <code>allowedRoots</code>, and optionally a <code>directTransfer</code> UDP range. The default pool is <code>49152-49215</code>; set the range start and end to the same value when the Node must use one fixed firewall port.</li><li>Restrict the configuration and entire data directory to the service account. They contain Node credentials, SQLite data, and logs; keep them out of npm package directories, Git, and chats.</li><li>Verify in the foreground with <code>mar-node run --config &lt;config-file&gt;</code>, then configure a Supervisor-backed service for production.</li></ol><p>For example, on Linux create a private JSON file, replacing every placeholder with your Server address, service account paths, and one-time registration key:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
22
22
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;serverUrl&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://mar.example.com&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
23
23
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;allowedRoots&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;/home/mar-node/workspaces&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
24
24
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;dataDirectory&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;/home/mar-node/.local/share/myagentroam&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
@@ -27,7 +27,7 @@
27
27
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>On Windows or macOS, use absolute paths appropriate to that service account; see the platform guides below. After registration, Node writes its ID and credential back to the configuration; the used <code>registrationToken</code> can be removed. When upgrading a configuration using the old <code>databasePath</code>, replace it with the containing <code>dataDirectory</code> and confirm the database is named <code>node-runtime.sqlite</code>; Node rejects the old field and does not move the data automatically.</p><p>For step 1, replace the placeholder before running:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">common_version</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;&lt;commonVersion from the product release manifest&gt;&#39;</span></span>
28
28
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --global</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@myagentroam/node@${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">common_version</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}&quot;</span></span>
29
29
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --global</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@myagentroam/node@${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">common_version</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --depth=0</span></span></code></pre></div><p>Supervisor stores versioned installations in the service account&#39;s writable Node data directory without sudo or UAC. After initial service setup, management upgrades only to the highest published stable npm version that meets the business baseline and does not exceed the current Server version, following explicit confirmation, and sends the selected exact version to Supervisor. See <a href="./upgrade">Upgrade MyAgentRoam</a>.</p><p>After setting up automatic startup, restart the service or host and confirm that Node reconnects and its upgrade status is not <strong>Enable Supervisor manually</strong>. A Node without Supervisor must first be installed manually at a version meeting the current business baseline and have its startup entry changed; it cannot bootstrap Supervisor through an unsupported remote operation.</p><p>After registration, open a Workspace and verify files, terminals, and Agent sessions. The Node needs outbound HTTPS/WSS and exposes no browser HTTP API. For authorized ordinary Workspace file, Git, and terminal direct connections, permit the configured UDP range only from the browser LAN; the Server relay remains available when direct connection cannot be established. A transfer already in progress can still fail and need a retry. Each Node process uses ICE UDP Mux to reuse one selected port. Multiple Nodes on one host can share the default pool and select separate free ports; assign distinct fixed ports or non-overlapping ranges when each Node needs isolation. For missing Agents, reproduce discovery under the service account; for MCP or Python failures, verify the exact <code>npx</code>, Python, and pip commands reported in Node details.</p><p>Configure automatic startup for the target platform: <a href="./node-linux">Linux systemd</a>, <a href="./node-windows">Windows Task Scheduler</a>, or <a href="./node-macos">macOS launchd</a>.</p><h2 id="web-fetch-browser-preparation" tabindex="-1">Web Fetch browser preparation <a class="header-anchor" href="#web-fetch-browser-preparation" aria-label="Permalink to &quot;Web Fetch browser preparation&quot;">​</a></h2><p>The Node npm package runs <code>postinstall</code> to prepare Chromium for its pinned Playwright version, reusing matching caches. Managed upgrades explicitly prepare the browser before switching versions even when npm lifecycle scripts are disabled; preparation failure keeps the previous version active. <code>mar-node install</code> / <code>upgrade</code> also run preparation. Ordinary startup and tool calls never download browsers.</p><p>Install under the final service account. The default cache belongs to the installation account. If installation and execution use different accounts, set the same <code>PLAYWRIGHT_BROWSERS_PATH</code> in both environments and grant the service account read/execute access. Offline deployments can prepopulate matching platform/version Chromium binaries and set <code>PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1</code>. Skipping does not establish browser availability. For manual preparation, run <code>scripts/install-web-browser.mjs</code> inside the installed Node package.</p><p>The npm control library, browser binaries, and Linux system libraries are separate. Node downloads browser binaries but never runs sudo/UAC or installs system packages automatically. For <code>MAR_AGENT_WEB_FETCH_BROWSER_UNAVAILABLE</code>, first check matching caches, account access, and paths. Minimal Linux hosts may also need Chromium system libraries installed by an administrator. HTTP mode does not require Chromium; errors never trigger an automatic mode switch.</p><p>Generated services default to <code>web-browsers/</code> in the Node data directory and use the same path for preparation and execution, preserving an explicit <code>PLAYWRIGHT_BROWSERS_PATH</code>. Linux units retain <code>ProtectSystem=strict</code> and allow writes to that cache; managed upgrades inherit the service environment. Existing services adopting this flow must regenerate and apply their service definitions using the platform guide. Node does not modify deployed services or accounts automatically. The final service account still needs read/execute access.</p></div></div></main><footer class="VPDocFooter" data-v-cd08f8de data-v-579b47ad><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-579b47ad><span class="visually-hidden" id="doc-footer-aria-label" data-v-579b47ad>Pager</span><div class="pager" data-v-579b47ad><a class="VPLink link pager-link prev" href="/docs/en-US/deployment/production" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>Previous</span><span class="title" data-v-579b47ad>Production Deployment and Reverse Proxy</span><!--]--></a></div><div class="pager" data-v-579b47ad><a class="VPLink link pager-link next" href="/docs/en-US/deployment/node-linux" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>Next</span><span class="title" data-v-579b47ad>Linux Node and systemd</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
30
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"CdgtKnVd\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"jmAMVJjC\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"CLCHq7k_\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"C4xlXyjC\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"B9varoSe\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"rWZ_VuoB\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
30
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"CVLEsGB6\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"Bbi7-zH2\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"CG_VFxvG\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"GCAYq1LT\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"770EzfaT\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DDevql7U\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"D46Ec15e\",\"en-us_getting-started_overview.md\":\"CB-43rGR\",\"en-us_getting-started_prerequisites.md\":\"BFxGOlUy\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"C7SjGDJt\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"xchi27R9\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"CIYjFmiu\",\"getting-started_overview.md\":\"Cv-HSfAh\",\"getting-started_prerequisites.md\":\"DjWWTA7V\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"BsEfVH6b\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"BQw1Wuiy\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
31
31
 
32
32
  </body>
33
33
  </html>