Vue d'ensemble

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.

Exigences

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.

Arguments d'exécution

Interface utilisateur Web: http://[IP]:[PORT:3000]/
Réseau: bridge
Coquille: sh
Privilégié: false
Paramètres supplémentaires: --add-host host.docker.internal:host-gateway

Configuration du modèle

WebUIPorttcp

OpenHands web interface

Cible: 3000
Défaut: 3000
Valeur: 3000

Config DirectoryPathrw

Persistent OpenHands configuration and state

Cible: /.openhands
Défaut: /mnt/user/appdata/openhands
Valeur: /mnt/user/appdata/openhands

Workspace DirectoryPathrw

Working directory exposed to the agent

Cible: /workspace
Défaut: /mnt/user/ai-workspace
Valeur: /mnt/user/ai-workspace

Docker SocketPathrw

Required so OpenHands can spawn isolated sandbox containers

Cible: /var/run/docker.sock
Défaut: /var/run/docker.sock
Valeur: /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.

Cible: SANDBOX_VOLUMES
Défaut: /mnt/user/ai-workspace:/workspace:rw
Valeur: /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').

Cible: LLM_API_KEY
Défaut: ollama
Valeur: ollama

LLM ModelVariable

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

Cible: LLM_MODEL
Défaut: ollama/qwen2.5-coder:14b
Valeur: 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.

Cible: LLM_BASE_URL
Défaut: http://host.docker.internal:11434
Valeur: http://host.docker.internal:11434

LLM Embedding ModelVariable

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

Cible: LLM_EMBEDDING_MODEL
Défaut: local
Valeur: local

Catégories

Tools > Utilities Utilities Productivity Development

Liens

Modèle Soutien Registre Proprojet

Détails

Référentiel

docker.openhands.dev/openhands/openhands:1.7

Registre

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

Dernière mise à jour2026-06-02

Première vue2026-05-14

Exécutez OpenHands sur Unraid.

OpenHands est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.

Explorez Unraid OS