Overview

OpenHands is an open-source AI-driven development agent. It writes, reviews, and tests code. Important: Requires access to the Docker socket to spin up isolated execution environments. Pre-configured for local Ollama use.

Requirements

A reachable Ollama instance (or any OpenAI-compatible LLM endpoint) configured via the LLM_* variables. Defaults assume Ollama running on the Unraid host, reachable via host.docker.internal.

Runtime arguments

Web UI: http://[IP]:[PORT:3000]/
Network: bridge
Shell: sh
Privileged: false
Extra Params: --add-host host.docker.internal:host-gateway

Template configuration

WebUIPorttcp

OpenHands web interface

Target: 3000
Default: 3000
Value: 3000

Config DirectoryPathrw

Persistent OpenHands configuration and state

Target: /.openhands
Default: /mnt/user/appdata/openhands
Value: /mnt/user/appdata/openhands

Workspace DirectoryPathrw

Working directory exposed to the agent

Target: /workspace
Default: /mnt/user/ai-workspace
Value: /mnt/user/ai-workspace

Docker SocketPathrw

Required so OpenHands can spawn isolated sandbox containers

Target: /var/run/docker.sock
Default: /var/run/docker.sock
Value: /var/run/docker.sock

Sandbox VolumesVariable

Host:container mount(s) injected into every sandbox container the agent spins up. Must match the Workspace Directory mapping.

Target: SANDBOX_VOLUMES
Default: /mnt/user/ai-workspace:/workspace:rw
Value: /mnt/user/ai-workspace:/workspace:rw

LLM API KeyVariable

API key for the LLM backend. For Ollama any non-empty value works (e.g. 'ollama').

Target: LLM_API_KEY
Default: ollama
Value: ollama

LLM ModelVariable

LiteLLM-style model string. Default targets Ollama with qwen2.5-coder:14b.

Target: LLM_MODEL
Default: ollama/qwen2.5-coder:14b
Value: ollama/qwen2.5-coder:14b

LLM Base URLVariable

Base URL of the LLM endpoint. Default reaches Ollama on the Unraid host via host.docker.internal. For a remote/LAN Ollama use http://host:11434. Leave blank for hosted providers (OpenAI/Anthropic/etc.) that use their own endpoints.

Target: LLM_BASE_URL
Default: http://host.docker.internal:11434
Value: http://host.docker.internal:11434

LLM Embedding ModelVariable

Embedding model used for memory/context. 'local' uses the bundled embedding model.

Target: LLM_EMBEDDING_MODEL
Default: local
Value: local

Links

Template Support Registry Project

Details

Repository

docker.openhands.dev/openhands/openhands:1.7

Registry

https://docker.openhands.dev/openhands/openhands

Last Updated2026-06-02

First Seen2026-05-14

Run OpenHands on Unraid.

OpenHands is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS

OpenHands