DTDeepSeek TUI GuideTerminal setup and usage hub
Home/Docs/Docker
Full Docs Article

DeepSeek TUI Docker Docs Guide

Docker docs describe how to run DeepSeek TUI in a more controlled environment, especially when host dependencies or isolation matter.

Upstream source: DOCKER.mdReadable on-siteFull article embedded below

What this document actually covers

Docker docs describe how to run DeepSeek TUI in a more controlled environment, especially when host dependencies or isolation matter.

How to use this page

  • Use the section list on the right to jump into the exact upstream section you need.
  • If you came here for one problem only, read the relevant heading first and return to the matching hub afterward.
  • If you need source verification, open the GitHub page or raw Markdown directly.

Full upstream document

Docker

DeepSeek TUI ships an official multi-arch Docker image (amd64 + arm64) on GitHub Container Registry.

Quick start

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:latest

Images are published to GitHub Container Registry (GHCR) only. Docker Hub publishing is not currently configured — add a docker/login-action step with Hub credentials to the release workflow if needed.

Environment variables

VariableRequiredDescription
DEEPSEEK_API_KEYyesDeepSeek API key
DEEPSEEK_BASE_URLnoCustom API base URL (e.g. https://api.deepseek.com)
DEEPSEEK_NO_COLORnoSet to 1 to disable terminal colour output

Volumes

Mount ~/.deepseek to persist sessions, config, skills, memory, and the offline queue across container restarts:

-v ~/.deepseek:/home/deepseek/.deepseek

Without this mount the container starts fresh each time.

Non-interactive / pipeline usage

When stdin is not a TTY, deepseek drops to the dispatcher's one-shot mode (deepseek -c "…"). Pipe a prompt on stdin:

echo "Explain the Cargo.toml in structured English." | \
  docker run --rm -i -e DEEPSEEK_API_KEY ghcr.io/hmbown/deepseek-tui:latest

Building locally

# Single platform (your host architecture)
docker build -t deepseek-tui .

# Multi-platform (requires a builder with emulation)
docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t deepseek-tui .

Devcontainer

The repository includes a .devcontainer/devcontainer.json configuration for VS Code / GitHub Codespaces. It pre-installs the Rust toolchain, rust-analyzer, and the deepseek binary. Open the repo in a devcontainer to get a ready-to-use development environment.

Tags

TagMeaning
latestLatest stable release
v0Latest v0.x release
0.8.9Specific release version

Docker images are built and pushed automatically when a release tag is pushed (see release.yml).

Back to top