deepseek-harness-docker
Community Docker and Kubernetes packaging for DeepSeek Harness (@deepseek-ai/dsh), with a hardened image, Compose stack, Helm chart, Web UI, and headless CLI.
What is deepseek-harness-docker?
Community Docker and Kubernetes packaging for DeepSeek Harness (@deepseek-ai/dsh), with a hardened image, Compose stack, Helm chart, Web UI, and headless CLI.
Overview of deepseek-harness-docker
What it is
DeepSeek Harness Docker is a community project that packages the official DeepSeek Harness (DSH) npm distribution into reproducible Docker images, with support for Docker Compose, Rootless Podman, and Helm chart deployments. It provides a hardened container image, a Web UI, a headless CLI, and an optional Chromium/noVNC desktop environment. The project does not modify DSH source code; it only wraps the official npm release. It has been maintained since August 13, 2026, and provides multi-architecture images for linux/arm64 and linux/amd64.
Key features
- Hardened Docker image based on
node:24-trixie, running as non-root user (UID 1000) with read-only root filesystem, dropped capabilities, and no-new-privileges. - Web UI accessible only on loopback by default; optional LAN overlay with Caddy HTTPS and Basic Auth.
- Headless CLI mode for CI/CD and batch processing.
- Data persistence separation:
DSH_HOME(profiles, settings, sessions) and workspace are stored separately, allowing image rebuilds without data loss. - Supports Docker Compose, Rootless Podman, and Helm (StatefulSet, PVC, NetworkPolicy) deployments.
- Includes Chromium browser and noVNC for visual desktop access.
- Upstream version tracking: daily checks for new DSH releases on GitHub and npm.
Use cases
- Deploying DeepSeek Harness in cloud environments for enterprise agent workflows.
- Running multiple isolated agent instances on Kubernetes with dynamic resource allocation.
- Testing and iterating on DSH versions in a containerized environment.
- Providing a secure, reproducible runtime for headless automation tasks.
Getting started
See the repository README for installation and quick-start instructions.
License and pricing
This project is licensed under the MIT License. It is open source and free to use.
Based on the project's public README and repository metadata.