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
ewogICJjb21wb3NlIjogIiMgVGhlICd2ZXJzaW9uJyBhdHRyaWJ1dGUgaXMgb2Jzb2xldGUgYW5kIGhhcyBiZWVuIHJlbW92ZWQuXG5zZXJ2aWNlczpcbiAgb3BlbmhhbmRzOlxuICAgICMgQ29ycmVjdGVkIHRoZSBEb2NrZXIgaW1hZ2UgdG8gd2hhdCBhcHBlYXJzIHRvIGJlIHRoZSBvZmZpY2lhbCByZWdpc3RyeSBwYXRoLlxuICAgICMgVGhpcyB3YXMgdGhlIGNhdXNlIG9mIHRoZSBcInB1bGwgYWNjZXNzIGRlbmllZFwiIGVycm9yLlxuICAgIGltYWdlOiBkb2NrZXIuYWxsLWhhbmRzLmRldi9hbGwtaGFuZHMtYWkvb3BlbmhhbmRzOmxhdGVzdFxuICAgIHJlc3RhcnQ6IHVubGVzcy1zdG9wcGVkXG5cbiAgICAjIFRoZSBwb3J0IGlzIGV4cG9zZWQgd2l0aG91dCBtYXBwaW5nLiBEb2twbG95IGhhbmRsZXMgdGhlIHJvdXRpbmcgdmlhIHRoZSBkb21haW4uXG4gICAgcG9ydHM6XG4gICAgICAtIFwiMzAwMFwiXG5cbiAgICAjIEVudmlyb25tZW50IHZhcmlhYmxlcyBhcmUgc291cmNlZCBmcm9tIHRoZSB0ZW1wbGF0ZS50b21sIGZpbGUuXG4gICAgZW52aXJvbm1lbnQ6XG4gICAgICAtIFNBTkRCT1hfUlVOVElNRV9DT05UQUlORVJfSU1BR0U9JHtTQU5EQk9YX1JVTlRJTUVfQ09OVEFJTkVSX0lNQUdFfVxuICAgICAgLSBXT1JLU1BBQ0VfTU9VTlRfUEFUSD0vb3B0L3dvcmtzcGFjZV9iYXNlXG5cbiAgICAjIEFsbG93cyB0aGUgY29udGFpbmVyIHRvIGNvbW11bmljYXRlIHdpdGggdGhlIGhvc3QncyBEb2NrZXIgZGFlbW9uLlxuICAgIGV4dHJhX2hvc3RzOlxuICAgICAgLSBcImhvc3QuZG9ja2VyLmludGVybmFsOmhvc3QtZ2F0ZXdheVwiXG5cbiAgICAjIFZvbHVtZXMgZm9yIHBlcnNpc3RlbnQgZGF0YS4gTmFtZWQgdm9sdW1lcyBhcmUgdXNlZCBpbnN0ZWFkIG9mIGhvc3QgbW91bnRzLlxuICAgICMgVGhlIGRvY2tlciBzb2NrZXQgaXMgbW91bnRlZCB0byBhbGxvdyBPcGVuSGFuZHMgdG8gbWFuYWdlIG90aGVyIGNvbnRhaW5lcnMuXG4gICAgdm9sdW1lczpcbiAgICAgIC0gL3Zhci9ydW4vZG9ja2VyLnNvY2s6L3Zhci9ydW4vZG9ja2VyLnNvY2tcbiAgICAgIC0gb3BlbmhhbmRzLWNvbmZpZzovLm9wZW5oYW5kc1xuICAgICAgLSBvcGVuaGFuZHMtd29ya3NwYWNlOi9vcHQvd29ya3NwYWNlX2Jhc2VcblxuICAgICMgVGhlc2UgZmxhZ3MgYXJlIG5lY2Vzc2FyeSBmb3IgdGhlIGludGVyYWN0aXZlIHNoZWxsIGZ1bmN0aW9uYWxpdHkgb2YgT3BlbkhhbmRzLlxuICAgIHN0ZGluX29wZW46IHRydWVcbiAgICB0dHk6IHRydWVcblxuIyBOYW1lZCB2b2x1bWVzIGFyZSBkZWZpbmVkIGhlcmUgdG8gcGVyc2lzdCBjb25maWd1cmF0aW9uIGFuZCB3b3Jrc3BhY2UgZGF0YS5cbnZvbHVtZXM6XG4gIG9wZW5oYW5kcy1jb25maWc6IHt9XG4gIG9wZW5oYW5kcy13b3Jrc3BhY2U6IHt9IiwKICAiY29uZmlnIjogIlt2YXJpYWJsZXNdXG5tYWluX2RvbWFpbiA9IFwiJHtkb21haW59XCJcbm9wZW5oYW5kc19hcGlfa2V5ID0gXCIke3Bhc3N3b3JkOjY0fVwiXG5cbltjb25maWddXG5bW2NvbmZpZy5kb21haW5zXV1cbnNlcnZpY2VOYW1lID0gXCJvcGVuaGFuZHNcIlxucG9ydCA9IDMwMDBcbmhvc3QgPSBcIiR7bWFpbl9kb21haW59XCJcblxuW2NvbmZpZy5lbnZdXG5TQU5EQk9YX1JVTlRJTUVfQ09OVEFJTkVSX0lNQUdFPVwiZG9ja2VyLmFsbC1oYW5kcy5kZXYvYWxsLWhhbmRzLWFpL3J1bnRpbWU6MC41MC1uaWtvbGFpa1wiXG5cbiMgRGVmaW5lcyBhIGZpbGUgbW91bnQgdG8gY3JlYXRlIHRoZSBPcGVuSGFuZHMgY29uZmlndXJhdGlvbiBmaWxlIGluc2lkZSB0aGUgY29udGFpbmVyLlxuIyBUaGUgZmlsZSB3aWxsIGJlIHBsYWNlZCB3aXRoaW4gdGhlICdvcGVuaGFuZHMtY29uZmlnJyB2b2x1bWUuXG5bW2NvbmZpZy5tb3VudHNdXVxuZmlsZVBhdGggPSBcIi8ub3BlbmhhbmRzL2NvbmZpZy50b21sXCJcbmNvbnRlbnQgPSBcIlwiXCJcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMgT3BlbkhhbmRzIENvbmZpZ3VyYXRpb24gRXhhbXBsZSAjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG4jXG4jIEFsbCBzZXR0aW5ncyBoYXZlIGRlZmF1bHQgdmFsdWVzLCBzbyB5b3Ugb25seSBuZWVkIHRvIHVuY29tbWVudCBhbmRcbiMgbW9kaWZ5IHdoYXQgeW91IHdhbnQgdG8gY2hhbmdlXG4jIFRoZSBmaWVsZHMgd2l0aGluIGVhY2ggc2VjdGlvbiBhcmUgc29ydGVkIGluIGFscGhhYmV0aWNhbCBvcmRlci5cbiNcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMgQ29yZSAjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbiMgR2VuZXJhbCBjb3JlIGNvbmZpZ3VyYXRpb25zXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbltjb3JlXVxuIyB3b3Jrc3BhY2VfYmFzZSA9IFwiLi93b3Jrc3BhY2VcIlxuIyBjYWNoZV9kaXIgPSBcIi90bXAvY2FjaGVcIlxuIyBkZWJ1ZyA9IGZhbHNlXG4jIGRpc2FibGVfY29sb3IgPSBmYWxzZVxuIyBzYXZlX3RyYWplY3RvcnlfcGF0aD1cIi4vdHJhamVjdG9yaWVzXCJcbiMgc2F2ZV9zY3JlZW5zaG90c19pbl90cmFqZWN0b3J5ID0gZmFsc2VcbiMgcmVwbGF5X3RyYWplY3RvcnlfcGF0aCA9IFwiXCJcbiMgZmlsZV9zdG9yZV9wYXRoID0gXCIvdG1wL2ZpbGVfc3RvcmVcIlxuIyBmaWxlX3N0b3JlID0gXCJtZW1vcnlcIlxuIyBmaWxlX3VwbG9hZHNfbWF4X2ZpbGVfc2l6ZV9tYiA9IDBcbiMgZW5hYmxlX2Jyb3dzZXIgPSB0cnVlXG4jIG1heF9idWRnZXRfcGVyX3Rhc2sgPSAwLjBcbiMgbWF4X2l0ZXJhdGlvbnMgPSA1MDBcbiMgd29ya3NwYWNlX21vdW50X3BhdGhfaW5fc2FuZGJveCA9IFwiL3dvcmtzcGFjZVwiXG4jIHdvcmtzcGFjZV9tb3VudF9wYXRoID0gXCJcIlxuIyB3b3Jrc3BhY2VfbW91bnRfcmV3cml0ZSA9IFwiXCJcbiMgcnVuX2FzX29wZW5oYW5kcyA9IHRydWVcbiMgcnVudGltZSA9IFwiZG9ja2VyXCJcbiMgZGVmYXVsdF9hZ2VudCA9IFwiQ29kZUFjdEFnZW50XCJcbiMgand0X3NlY3JldCA9IFwiXCJcbiMgZmlsZV91cGxvYWRzX3Jlc3RyaWN0X2ZpbGVfdHlwZXMgPSBmYWxzZVxuIyBmaWxlX3VwbG9hZHNfYWxsb3dlZF9leHRlbnNpb25zID0gW1wiLipcIl1cbiMgZW5hYmxlX2RlZmF1bHRfY29uZGVuc2VyID0gdHJ1ZVxuIyBtYXhfY29uY3VycmVudF9jb252ZXJzYXRpb25zID0gM1xuIyBjb252ZXJzYXRpb25fbWF4X2FnZV9zZWNvbmRzID0gODY0MDAwwqAgIyAxMCBkYXlzXG5cbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyBMTE0gIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuIyBDb25maWd1cmF0aW9uIGZvciBMTE0gbW9kZWxzIChncm91cCBuYW1lIHN0YXJ0cyB3aXRoICdsbG0nKVxuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG5bbGxtXVxuIyBBUEkga2V5IHRvIHVzZS4gSXQgaXMgYmVpbmcgc291cmNlZCBmcm9tIHRoZSBEb2twbG95IHRlbXBsYXRlIHZhcmlhYmxlcy5cbmFwaV9rZXkgPSBcIiR7b3BlbmhhbmRzX2FwaV9rZXl9XCIgIyBBUEkgS2V5XG4jIGJhc2VfdXJsID0gXCJcIlxuIyBhcGlfdmVyc2lvbiA9IFwiXCJcbiMgcmVhc29uaW5nX2VmZm9ydCA9IFwibWVkaXVtXCJcbiMgaW5wdXRfY29zdF9wZXJfdG9rZW4gPSAwLjBcbiMgb3V0cHV0X2Nvc3RfcGVyX3Rva2VuID0gMC4wXG4jIGN1c3RvbV9sbG1fcHJvdmlkZXIgPSBcIlwiXG4jIG1heF9tZXNzYWdlX2NoYXJzID0gMTAwMDBcbiMgbWF4X2lucHV0X3Rva2VucyA9IDBcbiMgbWF4X291dHB1dF90b2tlbnMgPSAwXG5tb2RlbCA9IFwiZ3B0LTRvXCJcbiMgbnVtX3JldHJpZXMgPSA4XG4jIHJldHJ5X21heF93YWl0ID0gMTIwXG4jIHJldHJ5X21pbl93YWl0ID0gMTVcbiMgcmV0cnlfbXVsdGlwbGllciA9IDIuMFxuIyBkcm9wX3BhcmFtcyA9IGZhbHNlXG4jIG1vZGlmeV9wYXJhbXMgPSB0cnVlXG4jIGNhY2hpbmdfcHJvbXB0ID0gdHJ1ZVxuIyBvbGxhbWFfYmFzZV91cmwgPSBcIlwiXG4jIHRlbXBlcmF0dXJlID0gMC4wXG4jIHRpbWVvdXQgPSAwXG4jIHRvcF9wID0gMS4wXG4jIGRpc2FibGVfdmlzaW9uID0gdHJ1ZVxuIyBjdXN0b21fdG9rZW5pemVyID0gXCJcIlxuIyBuYXRpdmVfdG9vbF9jYWxsaW5nID0gTm9uZVxuIyBzYWZldHlfc2V0dGluZ3MgPSBbXVxuXG5bbGxtLmRyYWZ0X2VkaXRvcl1cbiMgY29ycmVjdF9udW0gPSA1XG5cbltsbG0uZ3B0NG8tbWluaV1cbmFwaV9rZXkgPSBcIiR7b3BlbmhhbmRzX2FwaV9rZXl9XCIgIyBBUEkgS2V5XG5tb2RlbCA9IFwiZ3B0LTRvXCJcblxuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIEFnZW50ICMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG4jIENvbmZpZ3VyYXRpb24gZm9yIGFnZW50c1xuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjXG5bYWdlbnRdXG5lbmFibGVfQnJvd3NlID0gdHJ1ZVxuIyBlbmFibGVfbGxtX2VkaXRvciA9IGZhbHNlXG5lbmFibGVfZWRpdG9yID0gdHJ1ZVxuZW5hYmxlX2p1cHl0ZXIgPSB0cnVlXG5lbmFibGVfY21kID0gdHJ1ZVxuZW5hYmxlX3RoaW5rID0gdHJ1ZVxuZW5hYmxlX2ZpbmlzaCA9IHRydWVcbiMgbGxtX2NvbmZpZyA9ICd5b3VyLWxsbS1jb25maWctZ3JvdXAnXG4jIGVuYWJsZV9wcm9tcHRfZXh0ZW5zaW9ucyA9IHRydWVcbiMgZGlzYWJsZWRfbWljcm9hZ2VudHMgPSBbXVxuZW5hYmxlX2hpc3RvcnlfdHJ1bmNhdGlvbiA9IHRydWVcbiMgZW5hYmxlX2NvbmRlbnNhdGlvbl9yZXF1ZXN0ID0gZmFsc2VcblxuIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIFNhbmRib3ggIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbiMgQ29uZmlndXJhdGlvbiBmb3IgdGhlIHNhbmRib3hcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuW3NhbmRib3hdXG4jIHRpbWVvdXQgPSAxMjBcbiMgdXNlcl9pZCA9IDEwMDBcbiMgYmFzZV9jb250YWluZXJfaW1hZ2UgPSBcIm5pa29sYWlrL3B5dGhvbi1ub2RlanM6cHl0aG9uMy4xMi1ub2RlanMyMlwiXG4jIHVzZV9ob3N0X25ldHdvcmsgPSBmYWxzZVxuIyBydW50aW1lX2V4dHJhX2J1aWxkX2FyZ3MgPSBbXCItLW5ldHdvcms9aG9zdFwiLCBcIi0tYWRkLWhvc3Q9aG9zdC5kb2NrZXIuaW50ZXJuYWw6aG9zdC1nYXRld2F5XCJdXG4jIGVuYWJsZV9hdXRvX2xpbnQgPSBmYWxzZVxuIyBpbml0aWFsaXplX3BsdWdpbnMgPSB0cnVlXG4jIHJ1bnRpbWVfZXh0cmFfZGVwcyA9IFwiXCJcbiMgcnVudGltZV9zdGFydHVwX2Vudl92YXJzID0ge31cbiMgYnJvd3Nlcmd5bV9ldmFsX2VudiA9IFwiXCJcbiMgcGxhdGZvcm0gPSBcIlwiXG4jIGZvcmNlX3JlYnVpbGRfcnVudGltZSA9IGZhbHNlXG4jIHJ1bnRpbWVfY29udGFpbmVyX2ltYWdlID0gXCJcIlxuIyBrZWVwX3J1bnRpbWVfYWxpdmUgPSBmYWxzZVxuIyBwYXVzZV9jbG9zZWRfcnVudGltZXMgPSBmYWxzZVxuIyBjbG9zZV9kZWxheSA9IDMwMFxuIyBybV9hbGxfY29udGFpbmVycyA9IGZhbHNlXG4jIGVuYWJsZV9ncHUgPSBmYWxzZVxuIyBjdWRhX3Zpc2libGVfZGV2aWNlcyA9ICcnXG4jIGRvY2tlcl9ydW50aW1lX2t3YXJncyA9IHt9XG4jIHZzY29kZV9wb3J0ID0gNDEyMzRcbiMgdm9sdW1lcyA9IFwiL215L2hvc3QvZGlyOi93b3Jrc3BhY2U6cncsL3BhdGgyOi93b3Jrc3BhY2UvcGF0aDI6cm9cIlxuXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMgU2VjdXJpdHkgIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyNcbiMgQ29uZmlndXJhdGlvbiBmb3Igc2VjdXJpdHkgZmVhdHVyZXNcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuW3NlY3VyaXR5XVxuIyBjb25maXJtYXRpb25fbW9kZSA9IGZhbHNlXG4jIHNlY3VyaXR5X2FuYWx5emVyID0gXCJcIlxuIyBlbmFibGVfc2VjdXJpdHlfYW5hbHl6ZXIgPSBmYWxzZVxuXG4jIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMgQ29uZGVuc2VyICMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuIyBDb25kZW5zZXJzIGNvbnRyb2wgaG93IGNvbnZlcnNhdGlvbiBoaXN0b3J5IGlzIG1hbmFnZWRcbiMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjI1xuW2NvbmRlbnNlcl1cbnR5cGUgPSBcIm5vb3BcIlxuXCJcIlwiIgp9
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 499+ other templates on your own infrastructure with a single click.