Visión general

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.

Requisitos

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.

Argumentos en tiempo de ejecución

Interfaz web: http://[IP]:[PORT:3000]/
Red: bridge
Concha: sh
Privilegiado: false
Parámetros adicionales: --add-host host.docker.internal:host-gateway

Configuración de plantillas

WebUIPorttcp

OpenHands web interface

Objetivo: 3000
Por defecto: 3000
Valor: 3000

Config DirectoryPathrw

Persistent OpenHands configuration and state

Objetivo: /.openhands
Por defecto: /mnt/user/appdata/openhands
Valor: /mnt/user/appdata/openhands

Workspace DirectoryPathrw

Working directory exposed to the agent

Objetivo: /workspace
Por defecto: /mnt/user/ai-workspace
Valor: /mnt/user/ai-workspace

Docker SocketPathrw

Required so OpenHands can spawn isolated sandbox containers

Objetivo: /var/run/docker.sock
Por defecto: /var/run/docker.sock
Valor: /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.

Objetivo: SANDBOX_VOLUMES
Por defecto: /mnt/user/ai-workspace:/workspace:rw
Valor: /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').

Objetivo: LLM_API_KEY
Por defecto: ollama
Valor: ollama

LLM ModelVariable

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

Objetivo: LLM_MODEL
Por defecto: ollama/qwen2.5-coder:14b
Valor: 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.

Objetivo: LLM_BASE_URL
Por defecto: http://host.docker.internal:11434
Valor: http://host.docker.internal:11434

LLM Embedding ModelVariable

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

Objetivo: LLM_EMBEDDING_MODEL
Por defecto: local
Valor: local

Categorías

Tools > Utilities Utilities Productivity Development

Enlaces

Plantilla Ayuda Registro Project

Detalles

Repositorio

docker.openhands.dev/openhands/openhands:1.7

Registro

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

Última actualización2026-06-02

Visto por primera vez2026-05-14

Ejecute OpenHands en Unraid.

OpenHands se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.

Explore Unraid OS