Übersicht

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.

Anforderungen

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.

Laufzeit-Argumente

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

Konfiguration der Vorlage

WebUIPorttcp

OpenHands web interface

Ziel: 3000
Standard: 3000
Wert: 3000

Config DirectoryPathrw

Persistent OpenHands configuration and state

Ziel: /.openhands
Standard: /mnt/user/appdata/openhands
Wert: /mnt/user/appdata/openhands

Workspace DirectoryPathrw

Working directory exposed to the agent

Ziel: /workspace
Standard: /mnt/user/ai-workspace
Wert: /mnt/user/ai-workspace

Docker SocketPathrw

Required so OpenHands can spawn isolated sandbox containers

Ziel: /var/run/docker.sock
Standard: /var/run/docker.sock
Wert: /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.

Ziel: SANDBOX_VOLUMES
Standard: /mnt/user/ai-workspace:/workspace:rw
Wert: /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').

Ziel: LLM_API_KEY
Standard: ollama
Wert: ollama

LLM ModelVariable

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

Ziel: LLM_MODEL
Standard: ollama/qwen2.5-coder:14b
Wert: 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.

Ziel: LLM_BASE_URL
Standard: http://host.docker.internal:11434
Wert: http://host.docker.internal:11434

LLM Embedding ModelVariable

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

Ziel: LLM_EMBEDDING_MODEL
Standard: local
Wert: local

Kategorien

Tools > Utilities Utilities Productivity Development

Links

Vorlage Unterstützung Registry Project

Einzelheiten

Repository

docker.openhands.dev/openhands/openhands:1.7

Registry

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

Zuletzt aktualisiert2026-06-02

Erstmals gesehen2026-05-14

Führen Sie OpenHands auf Unraid aus.

OpenHands ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.

Erkunden Sie Unraid OS