Back to Templates
Deploy OpenHands on Dokploy
- Install Dokploy on your server if you haven't already.
- In your Dokploy panel, open a project and click Create Service → Template.
- Search for OpenHands and click Create — Dokploy configures domains, environment variables, and volumes for you.
Alternatively, create a Compose service, go to Advanced → Import from Base64, and paste this payload:
base64
ewogICJjb21wb3NlIjogIiMgVGhlICd2ZXJzaW9uJyBhdHRyaWJ1dGUgaXMgb2Jzb2xldGUgYW5kIGhhcyBiZWVuIHJlbW92ZWQuXG5zZXJ2aWNlczpcbiAgb3BlbmhhbmRzOlxuICAgICMgQ29ycmVjdGVkIHRoZSBEb2NrZXIgaW1hZ2UgdG8gd2hhdCBhcHBlYXJzIHRvIGJlIHRoZSBvZmZpY2lhbCByZWdpc3RyeSBwYXRoLlxuICAgICMgVGhpcyB3YXMgdGhlIGNhdXNlIG9mIHRoZSBcInB1bGwgYWNjZXNzIGRlbmllZFwiIGVycm9yLlxuICAgIGltYWdlOiBkb2NrZXIuYWxsLWhhbmRzLmRldi9hbGwtaGFuZHMtYWkvb3BlbmhhbmRzOmxhdGVzdFxuICAgIHJlc3RhcnQ6IHVubGVzcy1zdG9wcGVkXG5cbiAgICAjIFRoZSBwb3J0IGlzIGV4cG9zZWQgd2l0aG91dCBtYXBwaW5nLiBEb2twbG95IGhhbmRsZXMgdGhlIHJvdXRpbmcgdmlhIHRoZSBkb21haW4uXG4gICAgZXhwb3NlOlxuICAgICAgLSBcIjMwMDBcIlxuICAgIGVudmlyb25tZW50OlxuICAgICAgLSBTQU5EQk9YX1JVTlRJTUVfQ09OVEFJTkVSX0lNQUdFPSR7U0FOREJPWF9SVU5USU1FX0NPTlRBSU5FUl9JTUFHRX1cbiAgICAgIC0gV09SS1NQQUNFX01PVU5UX1BBVEg9L29wdC93b3Jrc3BhY2VfYmFzZVxuXG4gICAgIyBBbGxvd3MgdGhlIGNvbnRhaW5lciB0byBjb21tdW5pY2F0ZSB3aXRoIHRoZSBob3N0J3MgRG9ja2VyIGRhZW1vbi5cbiAgICBleHRyYV9ob3N0czpcbiAgICAgIC0gXCJob3N0LmRvY2tlci5pbnRlcm5hbDpob3N0LWdhdGV3YXlcIlxuXG4gICAgIyBWb2x1bWVzIGZvciBwZXJzaXN0ZW50IGRhdGEuIE5hbWVkIHZvbHVtZXMgYXJlIHVzZWQgaW5zdGVhZCBvZiBob3N0IG1vdW50cy5cbiAgICAjIFRoZSBkb2NrZXIgc29ja2V0IGlzIG1vdW50ZWQgdG8gYWxsb3cgT3BlbkhhbmRzIHRvIG1hbmFnZSBvdGhlciBjb250YWluZXJzLlxuICAgIHZvbHVtZXM6XG4gICAgICAtIC92YXIvcnVuL2RvY2tlci5zb2NrOi92YXIvcnVuL2RvY2tlci5zb2NrXG4gICAgICAtIG9wZW5oYW5kcy1jb25maWc6Ly5vcGVuaGFuZHNcbiAgICAgIC0gb3BlbmhhbmRzLXdvcmtzcGFjZTovb3B0L3dvcmtzcGFjZV9iYXNlXG5cbiAgICAjIFRoZXNlIGZsYWdzIGFyZSBuZWNlc3NhcnkgZm9yIHRoZSBpbnRlcmFjdGl2ZSBzaGVsbCBmdW5jdGlvbmFsaXR5IG9mIE9wZW5IYW5kcy5cbiAgICBzdGRpbl9vcGVuOiB0cnVlXG4gICAgdHR5OiB0cnVlXG5cbiMgTmFtZWQgdm9sdW1lcyBhcmUgZGVmaW5lZCBoZXJlIHRvIHBlcnNpc3QgY29uZmlndXJhdGlvbiBhbmQgd29ya3NwYWNlIGRhdGEuXG52b2x1bWVzOlxuICBvcGVuaGFuZHMtY29uZmlnOiB7fVxuICBvcGVuaGFuZHMtd29ya3NwYWNlOiB7fSIsCiAgImNvbmZpZyI6ICJbdmFyaWFibGVzXVxubWFpbl9kb21haW4gPSBcIiR7ZG9tYWlufVwiXG5vcGVuaGFuZHNfYXBpX2tleSA9IFwiJHtwYXNzd29yZDo2NH1cIlxuXG5bY29uZmlnXVxuW1tjb25maWcuZG9tYWluc11dXG5zZXJ2aWNlTmFtZSA9IFwib3BlbmhhbmRzXCJcbnBvcnQgPSAzMDAwXG5ob3N0ID0gXCIke21haW5fZG9tYWlufVwiXG5cbltjb25maWcuZW52XVxuU0FOREJPWF9SVU5USU1FX0NPTlRBSU5FUl9JTUFHRT1cImRvY2tlci5hbGwtaGFuZHMuZGV2L2FsbC1oYW5kcy1haS9ydW50aW1lOjAuNTAtbmlrb2xhaWtcIlxuXG4jIERlZmluZXMgYSBmaWxlIG1vdW50IHRvIGNyZWF0ZSB0aGUgT3BlbkhhbmRzIGNvbmZpZ3VyYXRpb24gZmlsZSBpbnNpZGUgdGhlIGNvbnRhaW5lci5cbiMgVGhlIGZpbGUgd2lsbCBiZSBwbGFjZWQgd2l0aGluIHRoZSAnb3BlbmhhbmRzLWNvbmZpZycgdm9sdW1lLlxuW1tjb25maWcubW91bnRzXV1cbmZpbGVQYXRoID0gXCIvLm9wZW5oYW5kcy9jb25maWcudG9tbFwiXG5jb250ZW50ID0gXCJcIlwiXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIE9wZW5IYW5kcyBDb25maWd1cmF0aW9uIEV4YW1wbGUgIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuI1xuIyBBbGwgc2V0dGluZ3MgaGF2ZSBkZWZhdWx0IHZhbHVlcywgc28geW91IG9ubHkgbmVlZCB0byB1bmNvbW1lbnQgYW5kXG4jIG1vZGlmeSB3aGF0IHlvdSB3YW50IHRvIGNoYW5nZVxuIyBUaGUgZmllbGRzIHdpdGhpbiBlYWNoIHNlY3Rpb24gYXJlIHNvcnRlZCBpbiBhbHBoYWJldGljYWwgb3JkZXIuXG4jXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcblxuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIENvcmUgIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG4jIEdlbmVyYWwgY29yZSBjb25maWd1cmF0aW9uc1xuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG5bY29yZV1cbiMgd29ya3NwYWNlX2Jhc2UgPSBcIi4vd29ya3NwYWNlXCJcbiMgY2FjaGVfZGlyID0gXCIvdG1wL2NhY2hlXCJcbiMgZGVidWcgPSBmYWxzZVxuIyBkaXNhYmxlX2NvbG9yID0gZmFsc2VcbiMgc2F2ZV90cmFqZWN0b3J5X3BhdGg9XCIuL3RyYWplY3Rvcmllc1wiXG4jIHNhdmVfc2NyZWVuc2hvdHNfaW5fdHJhamVjdG9yeSA9IGZhbHNlXG4jIHJlcGxheV90cmFqZWN0b3J5X3BhdGggPSBcIlwiXG4jIGZpbGVfc3RvcmVfcGF0aCA9IFwiL3RtcC9maWxlX3N0b3JlXCJcbiMgZmlsZV9zdG9yZSA9IFwibWVtb3J5XCJcbiMgZmlsZV91cGxvYWRzX21heF9maWxlX3NpemVfbWIgPSAwXG4jIGVuYWJsZV9icm93c2VyID0gdHJ1ZVxuIyBtYXhfYnVkZ2V0X3Blcl90YXNrID0gMC4wXG4jIG1heF9pdGVyYXRpb25zID0gNTAwXG4jIHdvcmtzcGFjZV9tb3VudF9wYXRoX2luX3NhbmRib3ggPSBcIi93b3Jrc3BhY2VcIlxuIyB3b3Jrc3BhY2VfbW91bnRfcGF0aCA9IFwiXCJcbiMgd29ya3NwYWNlX21vdW50X3Jld3JpdGUgPSBcIlwiXG4jIHJ1bl9hc19vcGVuaGFuZHMgPSB0cnVlXG4jIHJ1bnRpbWUgPSBcImRvY2tlclwiXG4jIGRlZmF1bHRfYWdlbnQgPSBcIkNvZGVBY3RBZ2VudFwiXG4jIGp3dF9zZWNyZXQgPSBcIlwiXG4jIGZpbGVfdXBsb2Fkc19yZXN0cmljdF9maWxlX3R5cGVzID0gZmFsc2VcbiMgZmlsZV91cGxvYWRzX2FsbG93ZWRfZXh0ZW5zaW9ucyA9IFtcIi4qXCJdXG4jIGVuYWJsZV9kZWZhdWx0X2NvbmRlbnNlciA9IHRydWVcbiMgbWF4X2NvbmN1cnJlbnRfY29udmVyc2F0aW9ucyA9IDNcbiMgY29udmVyc2F0aW9uX21heF9hZ2Vfc2Vjb25kcyA9IDg2NDAwMMKgICMgMTAgZGF5c1xuXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMgTExNICMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbiMgQ29uZmlndXJhdGlvbiBmb3IgTExNIG1vZGVscyAoZ3JvdXAgbmFtZSBzdGFydHMgd2l0aCAnbGxtJylcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuW2xsbV1cbiMgQVBJIGtleSB0byB1c2UuIEl0IGlzIGJlaW5nIHNvdXJjZWQgZnJvbSB0aGUgRG9rcGxveSB0ZW1wbGF0ZSB2YXJpYWJsZXMuXG5hcGlfa2V5ID0gXCIke29wZW5oYW5kc19hcGlfa2V5fVwiICMgQVBJIEtleVxuIyBiYXNlX3VybCA9IFwiXCJcbiMgYXBpX3ZlcnNpb24gPSBcIlwiXG4jIHJlYXNvbmluZ19lZmZvcnQgPSBcIm1lZGl1bVwiXG4jIGlucHV0X2Nvc3RfcGVyX3Rva2VuID0gMC4wXG4jIG91dHB1dF9jb3N0X3Blcl90b2tlbiA9IDAuMFxuIyBjdXN0b21fbGxtX3Byb3ZpZGVyID0gXCJcIlxuIyBtYXhfbWVzc2FnZV9jaGFycyA9IDEwMDAwXG4jIG1heF9pbnB1dF90b2tlbnMgPSAwXG4jIG1heF9vdXRwdXRfdG9rZW5zID0gMFxubW9kZWwgPSBcImdwdC00b1wiXG4jIG51bV9yZXRyaWVzID0gOFxuIyByZXRyeV9tYXhfd2FpdCA9IDEyMFxuIyByZXRyeV9taW5fd2FpdCA9IDE1XG4jIHJldHJ5X211bHRpcGxpZXIgPSAyLjBcbiMgZHJvcF9wYXJhbXMgPSBmYWxzZVxuIyBtb2RpZnlfcGFyYW1zID0gdHJ1ZVxuIyBjYWNoaW5nX3Byb21wdCA9IHRydWVcbiMgb2xsYW1hX2Jhc2VfdXJsID0gXCJcIlxuIyB0ZW1wZXJhdHVyZSA9IDAuMFxuIyB0aW1lb3V0ID0gMFxuIyB0b3BfcCA9IDEuMFxuIyBkaXNhYmxlX3Zpc2lvbiA9IHRydWVcbiMgY3VzdG9tX3Rva2VuaXplciA9IFwiXCJcbiMgbmF0aXZlX3Rvb2xfY2FsbGluZyA9IE5vbmVcbiMgc2FmZXR5X3NldHRpbmdzID0gW11cblxuW2xsbS5kcmFmdF9lZGl0b3JdXG4jIGNvcnJlY3RfbnVtID0gNVxuXG5bbGxtLmdwdDRvLW1pbmldXG5hcGlfa2V5ID0gXCIke29wZW5oYW5kc19hcGlfa2V5fVwiICMgQVBJIEtleVxubW9kZWwgPSBcImdwdC00b1wiXG5cbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyBBZ2VudCAjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuIyBDb25maWd1cmF0aW9uIGZvciBhZ2VudHNcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuW2FnZW50XVxuZW5hYmxlX0Jyb3dzZSA9IHRydWVcbiMgZW5hYmxlX2xsbV9lZGl0b3IgPSBmYWxzZVxuZW5hYmxlX2VkaXRvciA9IHRydWVcbmVuYWJsZV9qdXB5dGVyID0gdHJ1ZVxuZW5hYmxlX2NtZCA9IHRydWVcbmVuYWJsZV90aGluayA9IHRydWVcbmVuYWJsZV9maW5pc2ggPSB0cnVlXG4jIGxsbV9jb25maWcgPSAneW91ci1sbG0tY29uZmlnLWdyb3VwJ1xuIyBlbmFibGVfcHJvbXB0X2V4dGVuc2lvbnMgPSB0cnVlXG4jIGRpc2FibGVkX21pY3JvYWdlbnRzID0gW11cbmVuYWJsZV9oaXN0b3J5X3RydW5jYXRpb24gPSB0cnVlXG4jIGVuYWJsZV9jb25kZW5zYXRpb25fcmVxdWVzdCA9IGZhbHNlXG5cbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyBTYW5kYm94ICMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG4jIENvbmZpZ3VyYXRpb24gZm9yIHRoZSBzYW5kYm94XG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbltzYW5kYm94XVxuIyB0aW1lb3V0ID0gMTIwXG4jIHVzZXJfaWQgPSAxMDAwXG4jIGJhc2VfY29udGFpbmVyX2ltYWdlID0gXCJuaWtvbGFpay9weXRob24tbm9kZWpzOnB5dGhvbjMuMTItbm9kZWpzMjJcIlxuIyB1c2VfaG9zdF9uZXR3b3JrID0gZmFsc2VcbiMgcnVudGltZV9leHRyYV9idWlsZF9hcmdzID0gW1wiLS1uZXR3b3JrPWhvc3RcIiwgXCItLWFkZC1ob3N0PWhvc3QuZG9ja2VyLmludGVybmFsOmhvc3QtZ2F0ZXdheVwiXVxuIyBlbmFibGVfYXV0b19saW50ID0gZmFsc2VcbiMgaW5pdGlhbGl6ZV9wbHVnaW5zID0gdHJ1ZVxuIyBydW50aW1lX2V4dHJhX2RlcHMgPSBcIlwiXG4jIHJ1bnRpbWVfc3RhcnR1cF9lbnZfdmFycyA9IHt9XG4jIGJyb3dzZXJneW1fZXZhbF9lbnYgPSBcIlwiXG4jIHBsYXRmb3JtID0gXCJcIlxuIyBmb3JjZV9yZWJ1aWxkX3J1bnRpbWUgPSBmYWxzZVxuIyBydW50aW1lX2NvbnRhaW5lcl9pbWFnZSA9IFwiXCJcbiMga2VlcF9ydW50aW1lX2FsaXZlID0gZmFsc2VcbiMgcGF1c2VfY2xvc2VkX3J1bnRpbWVzID0gZmFsc2VcbiMgY2xvc2VfZGVsYXkgPSAzMDBcbiMgcm1fYWxsX2NvbnRhaW5lcnMgPSBmYWxzZVxuIyBlbmFibGVfZ3B1ID0gZmFsc2VcbiMgY3VkYV92aXNpYmxlX2RldmljZXMgPSAnJ1xuIyBkb2NrZXJfcnVudGltZV9rd2FyZ3MgPSB7fVxuIyB2c2NvZGVfcG9ydCA9IDQxMjM0XG4jIHZvbHVtZXMgPSBcIi9teS9ob3N0L2Rpcjovd29ya3NwYWNlOnJ3LC9wYXRoMjovd29ya3NwYWNlL3BhdGgyOnJvXCJcblxuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIFNlY3VyaXR5ICMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG4jIENvbmZpZ3VyYXRpb24gZm9yIHNlY3VyaXR5IGZlYXR1cmVzXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbltzZWN1cml0eV1cbiMgY29uZmlybWF0aW9uX21vZGUgPSBmYWxzZVxuIyBzZWN1cml0eV9hbmFseXplciA9IFwiXCJcbiMgZW5hYmxlX3NlY3VyaXR5X2FuYWx5emVyID0gZmFsc2VcblxuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIENvbmRlbnNlciAjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbiMgQ29uZGVuc2VycyBjb250cm9sIGhvdyBjb252ZXJzYXRpb24gaGlzdG9yeSBpcyBtYW5hZ2VkXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbltjb25kZW5zZXJdXG50eXBlID0gXCJub29wXCJcblwiXCJcIiIKfQ==
Configuration
The exact Docker Compose and template configuration this template deploys.
Related Templates
Anse
Version: latest
Anse is an open-source alternative to ChatGPT web UI, supporting OpenAI-compatible APIs.
aichatbotopenai
AnythingLLM
Version: latest
AnythingLLM is a private, self-hosted, and local document chatbot platform that allows you to chat with your documents using various LLM providers.
aillmchatbot
Arche
Version: latest
Arche is a self-hosted AI workspace platform that spawns per-user OpenCode coding containers backed by a shared Knowledge Base. Requires the `arche-internal` external Docker network and `/opt/arche/{kb-content,kb-config,users}` directories on the host before deploy. Images are linux/amd64 by default; override `ARCHE_WEB_IMAGE` and `ARCHE_WORKSPACE_IMAGE` to the `-arm64` tag variants for ARM64 hosts.
aicodingworkspace
bolt.diy
Version: latest
Prompt, run, edit, and deploy full-stack web applications using any LLM you want!
aiself-hosteddevelopment
Crawl4AI
Version: 0.7.3
Crawl4AI is a modern AI-powered web crawler with support for screenshots, PDFs, JavaScript execution, and LLM-based extraction. Includes an interactive playground and MCP (Model Context Protocol) integration.
crawlerscrapingai
Dify
Version: 1.15.0
Dify is an open-source LLM app development platform. Build AI workflows, RAG pipelines, agents and chatbots with a visual interface and publish them as APIs or web apps.
aillmrag
Self-host OpenHands in minutes
Dokploy is a free, open source deployment platform. Deploy OpenHands and 517+ other templates on your own infrastructure with a single click.