The Docker Compose stack runs OpenHands Enterprise on a single machine. Use it to evaluate
OpenHands Enterprise with a small group of users. For production, we recommend
Kubernetes.
The script returns when every service is healthy, then prints the URL to open. On the first
start, the application pulls images, which can take several minutes.
2
Complete onboarding
Open the URL the script printed and follow the onboarding flow to create your first user and
configure your LLM provider.
By default, the stack is only reachable from the machine it runs on. To share it with others,
serve it over HTTPS with ngrok or run it on a
VM with your own domain.
Upgrade
Pull the latest changes, then restart the stack:
git pulldocker compose down./scripts/setup.sh
The application migrates its database on startup.
Stop and reset
Stop the stack with:
docker compose down
Your data is stored in Docker volumes and is kept when you stop the stack.
Reset
To delete all data and start over, stop any running sandbox containers, then remove the volumes:
docker compose down -v
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OpenHands Docs","colors":{"primary":"#99873c","light":"#ffe165","dark":"#ffe165"},"logo":{"light":"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/logo/light.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=49b636402b03f7279ca5e1afefeec1d2","dark":"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/logo/dark.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=e0c4017631cebc3a289798438e2c0d7a"},"favicon":"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/openhands/logo-square.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=6ef1bab575660ae6e2d44fcc57bc675f","appearance":{"default":"light"},"background":{"color":{"light":"#f7f3ee","dark":"#0B0D0E"}},"navbar":{"links":[],"primary":{"type":"github","href":"https://github.com/OpenHands/OpenHands"}},"footer":{"socials":{"slack":"https://openhands.dev/joinslack","github":"https://github.com/OpenHands"},"links":[{"header":"Links","items":[{"label":"Company","href":"https://openhands.dev/"},{"label":"Blog","href":"https://openhands.dev/blog"},{"label":"Cloud","href":"https://app.all-hands.dev"},{"label":"Enterprise","href":"https://openhands.dev/enterprise"}]}]},"seo":{"indexing":"navigable"},"integrations":{"gtm":{"tagId":"GTM-M9S7V5BQ"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"allhandsai","hasAudioNarration":false,"actualSubdomain":"allhandsai","customDomains":["docs.openhands.dev"],"gitSource":{"type":"github","owner":"openhands","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe60db111c5baa897d5253","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Cloud","count":197},{"language":"default","tag":"Cloud API","count":188},{"language":"default","tag":"REST API Reference","count":186},{"language":"default","tag":"SDK","count":128},{"language":"default","tag":"Guides","count":105},{"language":"default","tag":"API Reference","count":95},{"language":"default","tag":"Enterprise","count":78},{"language":"default","tag":"Agent Canvas","count":66},{"language":"default","tag":"Home","count":58},{"language":"default","tag":"Remote Agent Server","count":55}]},"assistantConfig":{"deflection":{"enabled":true,"email":"contact@openhands.dev","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#banner *{color:rgb(67, 66, 64)}.oh-arch{--oh-arch-bg: #fbf9f6;--oh-arch-surface: #f2ede5;--oh-arch-card: #ffffff;--oh-arch-line: #e2dbd0;--oh-arch-text: #1c1b19;--oh-arch-text-secondary: #6b675f;--oh-arch-text-tertiary: #a39e93;--oh-arch-accent: #ffe165;--oh-arch-hover: #99873c;margin:1.5rem 0;border:1px solid var(--oh-arch-line);border-radius:12px;background:var(--oh-arch-bg);color:var(--oh-arch-text);overflow:hidden}.dark .oh-arch{--oh-arch-bg: #111416;--oh-arch-surface: #171b1e;--oh-arch-card: #1c2124;--oh-arch-line: #2d3337;--oh-arch-text: #f1efe9;--oh-arch-text-secondary: #a3a19a;--oh-arch-text-tertiary: #6f726f;--oh-arch-hover: #ffe165}.oh-arch-header{padding:18px 20px 0}.oh-arch-eyebrow,.oh-arch-label{font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:10px;font-weight:500;letter-spacing:0.08em;color:var(--oh-arch-text-secondary);fill:var(--oh-arch-text-secondary)}.oh-arch-eyebrow{text-transform:uppercase}.oh-arch-scroll{overflow-x:auto;scrollbar-width:thin}.oh-arch-diagram{display:block;width:100%;min-width:640px;height:auto}.oh-arch-boundary{fill:var(--oh-arch-surface);stroke:var(--oh-arch-line);stroke-dasharray:5 5}.oh-arch-card{fill:var(--oh-arch-card);stroke:var(--oh-arch-line);transition:stroke 150ms ease}.oh-arch-service:hover .oh-arch-card,.oh-arch-service:focus-visible .oh-arch-card{stroke:var(--oh-arch-hover);stroke-width:2}.oh-arch-service:focus-visible{outline:none}.oh-arch-icon{color:var(--oh-arch-text-secondary)}.oh-arch-name{fill:var(--oh-arch-text);font-size:15px;font-weight:600;letter-spacing:-0.025em}.oh-arch-detail{fill:var(--oh-arch-text-secondary);font-size:12px}.oh-arch-accent{fill:var(--oh-arch-accent)}.oh-arch-app-paths,.oh-arch-worker-paths,.oh-arch-external-paths,.oh-arch-arrows{fill:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round}.oh-arch-app-paths{stroke:var(--oh-arch-text)}.oh-arch-worker-paths,.oh-arch-external-paths,.oh-arch-arrows{stroke:var(--oh-arch-text-tertiary)}.oh-arch-external-paths{stroke-dasharray:4 6}.oh-arch-caption{border-top:1px solid var(--oh-arch-line);padding:16px 20px;font-size:12px;line-height:1.6;color:var(--oh-arch-text-secondary)}.oh-arch-legend{display:flex;flex-wrap:wrap;gap:8px 20px}.oh-arch-legend span{display:flex;align-items:center;gap:8px}.oh-arch-legend i{display:inline-block;width:18px;border-top:2px solid}.oh-arch-key-app{color:var(--oh-arch-text)}.oh-arch-key-worker,.oh-arch-key-external{color:var(--oh-arch-text-tertiary)}.oh-arch-legend .oh-arch-key-external{border-top-style:dashed}.oh-arch-caption p{margin:8px 0 0}@media (prefers-reduced-motion: reduce){.oh-arch-card{transition:none}}"}],"page":{"pagePath":"enterprise/docker-compose","slug":"/enterprise/docker-compose","pageMetadata":{"title":"Docker Compose","description":"Run OpenHands Enterprise with Docker Compose","icon":"docker","href":"/enterprise/docker-compose"},"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: \"Run OpenHands Enterprise with Docker Compose\"\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`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Step,Steps}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Docker Compose stack runs OpenHands Enterprise on a single machine. Use it to evaluate\nOpenHands Enterprise with a small group of users. For production, we recommend\n`,_jsx(_components.a,{href:`/enterprise/k8s-install/index`,children:`Kubernetes`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Git`}),`\n`,_jsx(_components.li,{children:`Docker and Docker Compose`}),`\n`,_jsx(_components.li,{children:`An API key from your LLM provider`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`install`,children:`Install`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Start the stack`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`3`,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:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` clone`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://github.com/OpenHands/enterprise.git`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`cd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` enterprise`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./scripts/setup.sh`})}),`\n`]})})}),_jsx(_components.p,{children:`The script returns when every service is healthy, then prints the URL to open. On the first\nstart, the application pulls images, which can take several minutes.`})]}),_jsx(Step,{title:`Complete onboarding`,children:_jsx(_components.p,{children:`Open the URL the script printed and follow the onboarding flow to create your first user and\nconfigure your LLM provider.`})})]}),`\n`,_jsxs(_components.p,{children:[`On a fresh stack, follow the first Super Admin’s\n`,_jsx(_components.a,{href:`/enterprise/super-admin#setup-guide`,children:`setup guide`}),` to add an LLM, connect Git, and invite users.\nThis Enterprise guide is separate from the\n`,_jsx(_components.a,{href:`/openhands/usage/agent-canvas/first-time-setup`,children:`local Agent Canvas first-time wizard`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`share-with-your-team`,children:`Share with your team`}),`\n`,_jsxs(_components.p,{children:[`By default, the stack is only reachable from the machine it runs on. To share it with others,\nserve it over HTTPS with `,_jsx(_components.a,{href:`/enterprise/docker-compose/ngrok`,children:`ngrok`}),` or run it on a\n`,_jsx(_components.a,{href:`/enterprise/docker-compose/https`,children:`VM with your own domain`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`upgrade`,children:`Upgrade`}),`\n`,_jsx(_components.p,{children:`Pull the latest changes, then restart the stack:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,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:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` compose`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` down`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./scripts/setup.sh`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The application migrates its database on startup.`}),`\n`,_jsx(Heading,{level:`2`,id:`stop-and-reset`,children:`Stop and reset`}),`\n`,_jsx(_components.p,{children:`Stop the stack with:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` compose`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` down`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Your data is stored in Docker volumes and is kept when you stop the stack.`}),`\n`,_jsx(Heading,{level:`3`,id:`reset`,children:`Reset`}),`\n`,_jsx(_components.p,{children:`To delete all data and start over, stop any running sandbox containers, then remove the volumes:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` compose`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` down`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -v`})]}),`\n`]})})})]})}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":"Docker Compose","description":"Run OpenHands Enterprise with Docker Compose","icon":"docker","href":"/enterprise/docker-compose"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Install","slug":"install","depth":2,"children":[]},{"title":"Share with your team","slug":"share-with-your-team","depth":2,"children":[]},{"title":"Upgrade","slug":"upgrade","depth":2,"children":[]},{"title":"Stop and reset","slug":"stop-and-reset","depth":2,"children":[{"title":"Reset","slug":"reset","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/allhandsai/dddab338317a519d/openhands/reo-init.js","/_mintlify/custom/allhandsai/ae719f15d762e1fe/openhands/posthog-init.js","/_mintlify/custom/allhandsai/b35f7f3c3c83fb4c/openhands/canvas-handoff.js","/_mintlify/custom/allhandsai/771d6371c43b73b7/openhands/linkedin-copy-tracking.js","/_mintlify/custom/allhandsai/46724455a27ebfc6/openhands/copy-click-tracking.js"],"subdomain":"allhandsai","siteName":"OpenHands Docs","title":"Docker Compose - OpenHands Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T16:30:32.643Z","originalFileLocation":"enterprise/docker-compose.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Run OpenHands Enterprise with Docker Compose\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenHands Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Docker Compose - OpenHands Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Run OpenHands Enterprise with Docker Compose\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenHands Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openhands.dev/enterprise/docker-compose\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://allhandsai.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Docker+Compose\u0026amp;description=Run+OpenHands+Enterprise+with+Docker+Compose\u0026amp;theme=2eb43b0b1453a2072ec6e8c0\u0026amp;signature=cb38eed04aef480e445f61062eca609e54680399637c548563c44461125d85db\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Docker Compose - OpenHands Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Run OpenHands Enterprise with Docker Compose\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://allhandsai.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Docker+Compose\u0026amp;description=Run+OpenHands+Enterprise+with+Docker+Compose\u0026amp;theme=2eb43b0b1453a2072ec6e8c0\u0026amp;signature=cb38eed04aef480e445f61062eca609e54680399637c548563c44461125d85db\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/allhandsai/NJyVpY-OoVetrcKF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenHands Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#99873c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openhands.dev/enterprise/docker-compose\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/enterprise/docker-compose.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openhands.dev/#organization\",\"name\":\"OpenHands Docs\",\"url\":\"https://docs.openhands.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/logo/light.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=49b636402b03f7279ca5e1afefeec1d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openhands.dev#website\",\"name\":\"OpenHands Docs\",\"url\":\"https://docs.openhands.dev\",\"publisher\":{\"@id\":\"https://docs.openhands.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openhands.dev/enterprise/docker-compose#webpage\",\"url\":\"https://docs.openhands.dev/enterprise/docker-compose\",\"name\":\"Docker Compose\",\"description\":\"Run OpenHands Enterprise with Docker Compose\",\"dateModified\":\"2026-11-16T16:30:32.643Z\",\"isPartOf\":{\"@id\":\"https://docs.openhands.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openhands.dev/enterprise/docker-compose#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openhands.dev/enterprise/docker-compose#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Deployment\",\"item\":\"https://docs.openhands.dev/enterprise/docker-compose/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docker Compose\",\"item\":\"https://docs.openhands.dev/enterprise/docker-compose\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.openhands.dev/enterprise/docker-compose#article\",\"headline\":\"Docker Compose\",\"name\":\"Docker Compose\",\"description\":\"Run OpenHands Enterprise with Docker Compose\",\"url\":\"https://docs.openhands.dev/enterprise/docker-compose\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openhands.dev/enterprise/docker-compose#webpage\"},\"dateModified\":\"2026-11-16T16:30:32.643Z\",\"publisher\":{\"@id\":\"https://docs.openhands.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openhands.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenHands Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OpenHands Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/enterprise/docker-compose.md","siteName":"OpenHands Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/overview/introduction"}]},{"tab":"Agent Canvas","pages":[{"title":"Agent Canvas","href":"/openhands/usage/agent-canvas/overview"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk"}]},{"tab":"Cloud","pages":[{"title":"Cloud","href":"/openhands/usage/cloud/openhands-cloud"}]},{"tab":"Enterprise","pages":[{"group":"Get Started","pages":[{"title":"Overview","icon":"map","href":"/enterprise/overview"},{"group":"Why Enterprise","icon":"building","root":{"title":"OpenHands Enterprise","icon":"building","href":"/enterprise/index"},"pages":[{"title":"Enterprise vs. Open Source","sidebarTitle":"Enterprise vs. OSS","icon":"scale-balanced","href":"/enterprise/enterprise-vs-oss"}]},{"title":"Architecture","description":"How OpenHands Enterprise is put together — components, services, and required vs. optional external systems.","icon":"sitemap","href":"/enterprise/architecture"}]},{"group":"Deployment","pages":[{"group":"Compose","icon":"docker","root":{"title":"Docker Compose","icon":"docker","href":"/enterprise/docker-compose"},"pages":[{"title":"Docker Compose Architecture","sidebarTitle":"Architecture","description":"The workloads, network flows, and external connections in the OpenHands Enterprise Docker Compose stack","icon":"sitemap","href":"/enterprise/docker-compose/architecture"},{"title":"Run on a VM with HTTPS","sidebarTitle":"VM with HTTPS","description":"Run the Docker Compose stack on a Linux VM and serve it over HTTPS at your own domain","icon":"lock","href":"/enterprise/docker-compose/https"},{"title":"Serve with ngrok","sidebarTitle":"ngrok","description":"Give the Docker Compose stack a public HTTPS URL with ngrok","icon":"globe","href":"/enterprise/docker-compose/ngrok"}]},{"group":"Kubernetes","icon":"dharmachakra","root":{"title":"Kubernetes Installation","icon":"dharmachakra","href":"/enterprise/k8s-install/index"},"pages":[{"group":"Cloud Providers","icon":"cloud","pages":[{"title":"Amazon EKS","icon":"aws","href":"/enterprise/k8s-install/eks"},{"title":"Azure AKS","icon":"https://mintlify.s3.us-west-1.amazonaws.com/allhandsai/enterprise/images/azure-logo.svg","href":"/enterprise/k8s-install/aks"},{"title":"Google GKE","icon":"cloud","href":"/enterprise/k8s-install/gke"}]},{"title":"Installing Sysbox","sidebarTitle":"Sysbox","icon":"cube","href":"/enterprise/k8s-install/sysbox"},{"title":"DNS and TLS","icon":"lock","href":"/enterprise/k8s-install/dns-and-tls"},{"title":"Install with Helm","sidebarTitle":"Install with Helm","icon":"ship","href":"/enterprise/k8s-install/installation"},{"title":"Resource Limits","icon":"gauge-high","href":"/enterprise/k8s-install/resource-limits"},{"title":"Enable Automations with Helm","sidebarTitle":"Automations","icon":"clock","href":"/enterprise/k8s-install/automations"},{"title":"Upgrade Guidance","icon":"circle-up","href":"/enterprise/k8s-install/upgrade-guidance"}]},{"group":"VM Install","icon":"server","pages":[{"title":"Generic VM Quick Start","sidebarTitle":"Generic VM","icon":"server","href":"/enterprise/vm-install/generic-vm"},{"title":"AWS Quick Start","sidebarTitle":"AWS","icon":"aws","href":"/enterprise/vm-install/aws"},{"title":"Google Cloud Quick Start","sidebarTitle":"Google Cloud","icon":"google","href":"/enterprise/vm-install/google"},{"title":"Azure Quick Start","sidebarTitle":"Azure","icon":"microsoft","href":"/enterprise/vm-install/azure"},{"title":"Admin Console Configuration","sidebarTitle":"Admin Console","icon":"sliders","href":"/enterprise/vm-install/admin-console-configuration"},{"title":"Log Collection","icon":"file-lines","href":"/enterprise/vm-install/log-collection"},{"title":"Scaling the Cluster","sidebarTitle":"Scaling","icon":"server","href":"/enterprise/vm-install/scaling"}]},{"title":"Sizing Guide","icon":"ruler","href":"/enterprise/sizing-guide"}]},{"group":"Configuration","pages":[{"title":"Environment Variables","icon":"sliders","href":"/enterprise/environment-variables"},{"group":"Authentication (SSO)","icon":"shield-check","pages":[{"title":"SAML SSO","icon":"user-shield","href":"/enterprise/integrations/saml-sso"},{"title":"Authentik","icon":"key","href":"/enterprise/integrations/saml-providers/authentik"}]},{"group":"LLM Gateways","icon":"route","root":{"title":"External LLM Gateways","icon":"network-wired","href":"/enterprise/integrations/external-llm-gateways"},"pages":[{"title":"Azure LLM Gateway","sidebarTitle":"Azure","icon":"https://mintlify.s3.us-west-1.amazonaws.com/allhandsai/enterprise/images/azure-logo.svg","href":"/enterprise/integrations/azure-llm-gateway"},{"title":"AWS Bedrock LLM Gateway","sidebarTitle":"AWS Bedrock","icon":"cloud","href":"/enterprise/integrations/aws-bedrock-llm-gateway"},{"title":"Google LLM Gateway","sidebarTitle":"Google","icon":"google","href":"/enterprise/integrations/google-llm-gateway"}]},{"group":"Custom Sandbox Images","icon":"box","root":{"title":"Custom Sandbox Images","icon":"box","href":"/enterprise/custom-sandbox-images/index"},"pages":[{"title":"Building a Custom Sandbox Image","sidebarTitle":"Building Images","icon":"docker","href":"/enterprise/custom-sandbox-images/building-custom-images"},{"title":"Configuring Custom Sandbox Images","sidebarTitle":"Multiple Images","icon":"layer-group","href":"/enterprise/custom-sandbox-images/multiple-images-warm-pools"},{"title":"Single Image via Admin Console","sidebarTitle":"Admin Console","icon":"triangle-exclamation","href":"/enterprise/custom-sandbox-images/single-image-admin-console"},{"title":"Using Custom Images","sidebarTitle":"Using Images","icon":"play","href":"/enterprise/custom-sandbox-images/using-custom-images"}]},{"title":"Running Docker in the Agent Sandbox","sidebarTitle":"Docker in the Sandbox","icon":"docker","href":"/enterprise/docker-in-sandbox"},{"title":"External PostgreSQL","icon":"database","href":"/enterprise/external-postgres"},{"group":"Observability","icon":"chart-line","pages":[{"title":"Analytics","icon":"rocket","href":"/enterprise/analytics"},{"title":"External Observability Platforms","sidebarTitle":"External Platforms","icon":"chart-line","href":"/enterprise/integrations/observability-platforms"}]}]},{"group":"Integrations","pages":[{"title":"Integrations Overview","sidebarTitle":"Overview","icon":"puzzle-piece","href":"/enterprise/integrations/overview"},{"group":"Source Control","icon":"code-branch","pages":[{"title":"GitHub","icon":"github","href":"/enterprise/integrations/github"},{"title":"GitLab","icon":"code-branch","href":"/enterprise/integrations/gitlab"},{"title":"Azure DevOps","icon":"code-branch","href":"/enterprise/integrations/azure-devops"},{"title":"Bitbucket Data Center","icon":"code-branch","href":"/enterprise/integrations/bitbucket-data-center"}]},{"group":"Project Management","icon":"list-check","pages":[{"title":"Jira Cloud","icon":"cloud","href":"/enterprise/integrations/jira-cloud"},{"title":"Jira Data Center","icon":"building","href":"/enterprise/integrations/jira-data-center"}]},{"title":"Slack","icon":"slack","href":"/enterprise/integrations/slack"}]},{"group":"Features","pages":[{"title":"Conversations And Sandboxes","sidebarTitle":"Conversations","icon":"boxes-stacked","href":"/enterprise/conversations-and-sandboxes"},{"group":"Automations","icon":"bolt","root":{"title":"Automations","icon":"bolt","href":"/enterprise/automations"},"pages":[{"title":"Service Accounts","icon":"robot","href":"/enterprise/automations/service-accounts"},{"title":"GitHub Event Automations","icon":"github","href":"/enterprise/automations/github-events"},{"title":"Jira and Bitbucket Data Center Event Automations","icon":"building","href":"/enterprise/automations/data-center-events"}]},{"title":"Personal and Organization Agent Profiles (Beta)","icon":"id-card","href":"/enterprise/agent-profiles"},{"title":"Secrets Management","icon":"key","href":"/enterprise/secrets-management"},{"title":"Skills and Plugins","icon":"puzzle-piece","href":"/enterprise/skills-and-plugins"},{"title":"Plugin Marketplace","icon":"store","href":"/enterprise/plugin-marketplace"},{"group":"Organizations","icon":"building","pages":[{"title":"Organizations Overview","sidebarTitle":"Overview","href":"/openhands/usage/cloud/organizations/overview"},{"title":"Configuring Organizations","sidebarTitle":"Configuration","href":"/openhands/usage/cloud/organizations/configuring-organizations"},{"title":"Managing Members","sidebarTitle":"Members","href":"/openhands/usage/cloud/organizations/managing-members"},{"title":"Roles and Permissions","href":"/openhands/usage/cloud/organizations/roles-permissions"},{"title":"Organization Settings","sidebarTitle":"Settings","href":"/openhands/usage/cloud/organizations/settings"},{"title":"Budgets and Usage","sidebarTitle":"Budgets and Usage","href":"/openhands/usage/cloud/organizations/budgets"}]}]},{"group":"Administration","pages":[{"title":"Super Admin Dashboard","sidebarTitle":"Super Admin","icon":"user-shield","href":"/enterprise/super-admin"},{"title":"Troubleshooting","icon":"life-ring","href":"/enterprise/troubleshooting"},{"group":"Release Notes","icon":"rocket","pages":[{"title":"OpenHands Enterprise 0.110.0","href":"/enterprise/release-notes/0.110.0"},{"title":"OpenHands Enterprise 0.105.0","href":"/enterprise/release-notes/0.105.0"},{"title":"OpenHands Enterprise 0.103.0","href":"/enterprise/release-notes/0.103.0"},{"title":"OpenHands Enterprise 0.90.1","href":"/enterprise/release-notes/0.90.1"},{"title":"OpenHands Enterprise 0.81.0","href":"/enterprise/release-notes/0.81.0"},{"title":"OpenHands Enterprise 0.76.0","href":"/enterprise/release-notes/0.76.0"},{"title":"OpenHands Enterprise 0.74.0","href":"/enterprise/release-notes/0.74.0"},{"title":"OpenHands Enterprise 0.71.1","href":"/enterprise/release-notes/0.71.1"},{"title":"OpenHands Enterprise 0.70.0","href":"/enterprise/release-notes/0.70.0"},{"title":"OpenHands Enterprise 0.64.0","href":"/enterprise/release-notes/0.64.0"},{"title":"OpenHands Enterprise 0.55.0","href":"/enterprise/release-notes/0.55.0"},{"title":"OpenHands Enterprise 0.45.0","href":"/enterprise/release-notes/0.45.0"},{"title":"OpenHands Enterprise 0.41.0","href":"/enterprise/release-notes/0.41.0"},{"title":"OpenHands Enterprise 0.36.1","href":"/enterprise/release-notes/0.36.1"},{"title":"OpenHands Enterprise 0.36.0","href":"/enterprise/release-notes/0.36.0"},{"title":"OpenHands Enterprise 0.28.0","href":"/enterprise/release-notes/0.28.0"},{"title":"OpenHands Enterprise 0.24.0","href":"/enterprise/release-notes/0.24.0"}]}]}]},{"tab":"Enterprise Cookbook","pages":[{"title":"Enterprise Cookbook","href":"/cookbook"}]}]},"basePath":"","title":"Docker Compose - OpenHands Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}