Install the desktop app, complete first-run setup, and update without removing your workspace.
Download the available build for your computer from open-hive.com. Use the download page to confirm which operating systems and architectures are currently offered.The packaged app includes the runtime setup process. You do not need a development checkout, Node.js, or npm for normal use.
macOS
Windows
Linux
Download the .dmg matching your Mac’s architecture, when a choice is offered.
Open it and drag OpenHive into Applications.
Launch OpenHive from Applications and follow sign-in and setup.
If macOS reports a damaged or unverified download, get a fresh copy from the official download page. Do not disable system security to force an unverified copy to run.
Download and run the OpenHive setup .exe.
Follow the installer prompts. The desktop installer is configured for a machine-wide installation, so Windows may request administrator permission.
Launch OpenHive and complete sign-in and runtime setup.
Keep the installed app’s supporting files together. Use the formats actually offered on the download page; a portable build is not assumed.
If a Linux AppImage is offered, download it and make that file executable:
Replace the example path with the downloaded filename. If your distribution reports a FUSE error, follow its AppImage/FUSE instructions. Check the download page for other supported packages.
Keep an internet connection available while OpenHive prepares its runtime. A cold setup can take several minutes. Show details on the startup screen helps distinguish a download in progress from an error.Later launches can reuse installed dependencies, but an update or a changed runtime may require preparation again. If setup is interrupted, reopen the app and inspect its status; you do not need to delete your workspace.
Quit OpenHive before installing a newer release. Install the new version using the same platform workflow, then reopen it and confirm you are in the expected workspace.App files and workspace data are stored separately. Updating the app is different from deleting its application-data folders. Avoid deleting workspace folders as a troubleshooting shortcut.
Continue with Your first task. For startup errors, sign-in problems, or a second launch that seems to do nothing, see Troubleshooting.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OpenHive","description":"Documentation for OpenHive — the desktop app for running agent colonies.","colors":{"primary":"#B5691C","light":"#FABE0A","dark":"#B5691C"},"logo":{"light":"https://mintcdn.com/open-hive/KBnRuZMIKg-Do7q7/logo/light.svg?fit=max\u0026auto=format\u0026n=KBnRuZMIKg-Do7q7\u0026q=85\u0026s=8f01f060000a2934d8eba1cf75bbad73","dark":"https://mintcdn.com/open-hive/KBnRuZMIKg-Do7q7/logo/dark.svg?fit=max\u0026auto=format\u0026n=KBnRuZMIKg-Do7q7\u0026q=85\u0026s=7e541f706344da544c756182caca9700","href":"https://open-hive.com"},"favicon":"https://mintcdn.com/open-hive/KBnRuZMIKg-Do7q7/favicon.svg?fit=max\u0026auto=format\u0026n=KBnRuZMIKg-Do7q7\u0026q=85\u0026s=1718d5156763419a5d21aac3f25306f6","navbar":{"links":[{"href":"https://open-hive.com","label":"Website"},{"href":"https://discord.com/invite/MXE49hrKDk","label":"Discord"}],"primary":{"type":"button","label":"Download","href":"https://open-hive.com"}},"footer":{"socials":{"x":"https://x.com/aden_hq","github":"https://github.com/aden-hive","linkedin":"https://www.linkedin.com/company/teamaden","discord":"https://discord.com/invite/MXE49hrKDk"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"open-hive","hasAudioNarration":false,"actualSubdomain":"open-hive","customDomains":["docs.open-hive.com"],"gitSource":{"type":"github","owner":"aden-hive","repo":"open-hive-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6a9dd6a41d75eb55a84c3dc4","collectionId":"5c37c505-4e3c-4a0a-b930-714aa315dd6b","liveDeploymentHistoryId":"6a9dd6a41d75eb55a84c3dc4","schemaVersion":"v3"},"entitlements":{},"buildId":"6a9dd6a41d75eb55a84c3dc4","clientVersion":"0.0.3894","searchFilterCounts":[{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Colony workspace","count":6},{"language":"default","tag":"Core concepts","count":6},{"language":"default","tag":"Configuration","count":6},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Inbox and senders","count":5},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"API reference","count":2},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"Account","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"installation","slug":"/installation","pageMetadata":{"title":"Installation","description":"Install the desktop app, complete first-run setup, and update without removing your workspace.","href":"/installation"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install the desktop app, complete first-run setup, and update without removing your workspace.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tab,Tabs}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Download the available build for your computer from `,_jsx(_components.a,{href:`https://open-hive.com`,children:`open-hive.com`}),`. Use the download page to confirm which operating systems and architectures are currently offered.`]}),`\n`,_jsx(_components.p,{children:`The packaged app includes the runtime setup process. You do not need a development checkout, Node.js, or npm for normal use.`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`macOS`,id:`macos`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Download the `,_jsx(_components.code,{children:`.dmg`}),` matching your Mac’s architecture, when a choice is offered.`]}),`\n`,_jsxs(_components.li,{children:[`Open it and drag `,_jsx(_components.strong,{children:`OpenHive`}),` into `,_jsx(_components.strong,{children:`Applications`}),`.`]}),`\n`,_jsx(_components.li,{children:`Launch OpenHive from Applications and follow sign-in and setup.`}),`\n`]}),_jsx(_components.p,{children:`If macOS reports a damaged or unverified download, get a fresh copy from the official download page. Do not disable system security to force an unverified copy to run.`})]}),_jsxs(Tab,{title:`Windows`,id:`windows`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Download and run the OpenHive setup `,_jsx(_components.code,{children:`.exe`}),`.`]}),`\n`,_jsx(_components.li,{children:`Follow the installer prompts. The desktop installer is configured for a machine-wide installation, so Windows may request administrator permission.`}),`\n`,_jsx(_components.li,{children:`Launch OpenHive and complete sign-in and runtime setup.`}),`\n`]}),_jsx(_components.p,{children:`Keep the installed app’s supporting files together. Use the formats actually offered on the download page; a portable build is not assumed.`})]}),_jsxs(Tab,{title:`Linux`,id:`linux`,children:[_jsx(_components.p,{children:`If a Linux AppImage is offered, download it and make that file executable:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`chmod`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` +x`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /path/to/OpenHive.AppImage`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`/path/to/OpenHive.AppImage`})}),`\n`]})})}),_jsx(_components.p,{children:`Replace the example path with the downloaded filename. If your distribution reports a FUSE error, follow its AppImage/FUSE instructions. Check the download page for other supported packages.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`first-run-setup`,children:`First-run setup`}),`\n`,_jsxs(_components.p,{children:[`Keep an internet connection available while OpenHive prepares its runtime. A cold setup can take several minutes. `,_jsx(_components.strong,{children:`Show details`}),` on the startup screen helps distinguish a download in progress from an error.`]}),`\n`,_jsx(_components.p,{children:`Later launches can reuse installed dependencies, but an update or a changed runtime may require preparation again. If setup is interrupted, reopen the app and inspect its status; you do not need to delete your workspace.`}),`\n`,_jsx(Heading,{level:`2`,id:`updating`,children:`Updating`}),`\n`,_jsx(_components.p,{children:`Quit OpenHive before installing a newer release. Install the new version using the same platform workflow, then reopen it and confirm you are in the expected workspace.`}),`\n`,_jsx(_components.p,{children:`App files and workspace data are stored separately. Updating the app is different from deleting its application-data folders. Avoid deleting workspace folders as a troubleshooting shortcut.`}),`\n`,_jsx(Heading,{level:`2`,id:`ready-to-use-it`,children:`Ready to use it?`}),`\n`,_jsxs(_components.p,{children:[`Continue with `,_jsx(_components.a,{href:`/quickstart`,children:`Your first task`}),`. For startup errors, sign-in problems, or a second launch that seems to do nothing, see `,_jsx(_components.a,{href:`/troubleshooting`,children:`Troubleshooting`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Installation","description":"Install the desktop app, complete first-run setup, and update without removing your workspace.","href":"/installation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"First-run setup","slug":"first-run-setup","depth":2,"children":[]},{"title":"Updating","slug":"updating","depth":2,"children":[]},{"title":"Ready to use it?","slug":"ready-to-use-it","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"open-hive","siteName":"OpenHive","title":"Installation - OpenHive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-06T18:24:01.024Z","originalFileLocation":"installation.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"description\" content=\"Install the desktop app, complete first-run setup, and update without removing your workspace.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenHive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Installation - OpenHive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install the desktop app, complete first-run setup, and update without removing your workspace.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenHive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.open-hive.com/installation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Installation - OpenHive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install the desktop app, complete first-run setup, and update without removing your workspace.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/open-hive/cyvY73COFAppaB9_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenHive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#B5691C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.open-hive.com/installation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/installation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.open-hive.com/#organization\",\"name\":\"OpenHive\",\"url\":\"https://docs.open-hive.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/open-hive/KBnRuZMIKg-Do7q7/logo/light.svg?fit=max\u0026auto=format\u0026n=KBnRuZMIKg-Do7q7\u0026q=85\u0026s=8f01f060000a2934d8eba1cf75bbad73\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.open-hive.com#website\",\"name\":\"OpenHive\",\"url\":\"https://docs.open-hive.com\",\"publisher\":{\"@id\":\"https://docs.open-hive.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.open-hive.com/installation#webpage\",\"url\":\"https://docs.open-hive.com/installation\",\"name\":\"Installation\",\"description\":\"Install the desktop app, complete first-run setup, and update without removing your workspace.\",\"dateModified\":\"2026-09-06T18:24:01.024Z\",\"isPartOf\":{\"@id\":\"https://docs.open-hive.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.open-hive.com/installation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.open-hive.com/installation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://docs.open-hive.com/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Installation\",\"item\":\"https://docs.open-hive.com/installation\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.open-hive.com/installation#article\",\"headline\":\"Installation\",\"name\":\"Installation\",\"description\":\"Install the desktop app, complete first-run setup, and update without removing your workspace.\",\"url\":\"https://docs.open-hive.com/installation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.open-hive.com/installation#webpage\"},\"dateModified\":\"2026-09-06T18:24:01.024Z\",\"publisher\":{\"@id\":\"https://docs.open-hive.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.open-hive.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenHive\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenHive","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"OpenHive","href":""},{"title":"Your first task","description":"Install OpenHive and create a short competitor comparison you can inspect and refine.","href":"/quickstart"},{"title":"Installation","href":"/installation"},{"title":"Troubleshooting","description":"Find the next step for startup problems, waiting colonies, failed connections, schedules, and missing results.","href":"/troubleshooting"}]},{"group":"Core concepts","pages":[{"title":"How OpenHive organizes work","href":"/concepts/overview"},{"title":"Colonies","href":"/concepts/colonies"},{"title":"Queens","href":"/concepts/queens"},{"title":"Sessions and progress","href":"/concepts/sessions"},{"title":"Skills and tools","href":"/concepts/skills"},{"title":"Memory","href":"/concepts/memory"}]},{"group":"Colony workspace","pages":[{"title":"Working in a colony","href":"/guides/colony-workspace"},{"title":"Data: inspect and export results","href":"/colony/data"},{"title":"Plan: tasks, blockers, and history","href":"/colony/plan"},{"title":"Automation: run and supervise work","href":"/colony/automation"},{"title":"Schedule recurring work","href":"/guides/scheduling"},{"title":"Local and cloud work","href":"/guides/local-and-cloud"}]},{"group":"Inbox and senders","pages":[{"title":"Email: inboxes, accounts, and profiles","href":"/email/overview"},{"title":"Inboxes: sync and find conversations","sidebarTitle":"Inboxes","href":"/guides/inbox"},{"title":"Delivery accounts: connect a sender","sidebarTitle":"Delivery accounts","href":"/configuration/senders"},{"title":"Sending profiles: names and signatures","href":"/email/sending-profiles"},{"title":"Draft, preview, and send a reply","href":"/email/replying"}]},{"group":"Guides","pages":[{"title":"Write a useful task brief","href":"/guides/task-briefs"},{"title":"Find and qualify prospects","href":"/guides/first-colony"},{"title":"Foundry","href":"/guides/foundry"},{"title":"Use and customize prompts","href":"/guides/prompt-library"},{"title":"CRM","href":"/guides/crm"},{"title":"Connect your browser","href":"/guides/browser"}]},{"group":"Configuration","pages":[{"title":"Connect accounts and API keys","href":"/configuration/credentials"},{"title":"Set action limits","href":"/configuration/rate-limits"},{"title":"Manage skills and tools","href":"/configuration/skills-library"},{"title":"Memory library","href":"/configuration/memory-library"},{"title":"Org chart","href":"/configuration/org-chart"},{"title":"Settings and workspace","href":"/configuration/settings"}]},{"group":"Account","pages":[{"title":"Credits and model access","href":"/account/credits"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},"title":"Installation - OpenHive","buildId":"dpl_8LJVMfxYNq6LJkohTrn2iyWT8umj","deploymentId":"dpl_8LJVMfxYNq6LJkohTrn2iyWT8umj","dynamics":[],"chunks":[]}