Skip to main content

tdock — Docker container manager TUI

A terminal UI for managing Docker containers on shared GPU servers. Create containers with GPUs, mounts and ports from forms instead of long docker run commands, and change the settings of an existing container without losing what you installed inside.

Features

  • Containers: list with status, GPUs, ports and mounts; start/stop, restart, logs, shell, delete
  • Create from a form
    • Image: pick a local image, search Docker Hub (with tag sizes and dates), or pull by name
    • Resources: per-GPU toggles, memory limit, shared memory (/dev/shm), CPU limit (only if the daemon supports it)
    • Mounts: browse host folders and add them with →; read-only toggle; one-click "same path + /workspace"
    • Ports: host port / container port, add and remove from a list
    • Timezone: server timezone, any IANA zone, or the image default (works without tzdata in the image)
    • Options shown only when they apply: auto-restart, Docker inside the container (DooD), NVIDIA ulimits, host IPC (multi-GPU), debugger support
    • Live preview of the exact docker run command and validation before running
  • Recreate (m): commit the container, then rerun it with changed settings; rolls back automatically on failure
  • Images: pull, delete, run
  • GPU: memory and utilization per GPU, and which running containers can access it
  • Cleanup: disk usage, remove stopped containers, unused images, build cache

Requirements

  • Linux with the docker CLI and access to a Docker daemon (rootful or rootless)
  • Python 3.9+
  • nvidia-smi for GPU features (optional)

Install

Any Linux, no Python setup needed (uses uv, which fetches a Python if needed):

curl -LsSf https://astral.sh/uv/install.sh | sh   # once
uv tool install tdock

Or with the install script, which uses your Python 3.9+ if available and falls back to uv otherwise:

curl -fsSL https://raw.githubusercontent.com/Taepoung/tdock/main/install.sh | bash

If you already manage Python tools:

pipx install tdock
pip install tdock      # inside a virtualenv / conda env

On recent Debian/Ubuntu, a plain pip install into the system Python is blocked (externally-managed-environment); use one of the methods above.

Update with uv tool upgrade tdock, pipx upgrade tdock or pip install -U tdock.

Usage

tdock
Tab Keys
Containers n new, m recreate, s start/stop, t restart, e shell, l logs, d delete
Images n run this image, p pull, d delete
Mount folder tree → add mount, Backspace parent, o open folder, r refresh
Everywhere F5 refresh, q quit, Ctrl+R run (in the form), Esc cancel

Notes

  • Rootless Docker: detected automatically. Options the daemon cannot honor are hidden (for example the CPU limit when the cpu cgroup controller is not delegated, or memlock=-1).
  • Running tdock inside a container: if your shell is itself a container that talks to the host daemon, host paths can differ from what you see. tdock detects this, translates mount paths to the paths the daemon sees, and blocks paths that only exist inside your container (such as /tmp).
  • Mounts use --mount so a missing host path fails instead of silently creating an empty directory.
  • DooD mounts the Docker socket, the docker binary and CLI plugins. The binary mount works in glibc-based images (Ubuntu, Debian), not in Alpine.

Files

  • ~/.config/tdock/state.json: last used image and timezone, detected server timezone
  • ~/.config/tdock/pathmap.json: cached host path translation (only when running inside a container)

License

MIT

Metadata

Release files for tdock 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tdock 0.1.2
File Size Uploaded Provenance Actions
tdock-0.1.2.tar.gz 31.6 kB Without provenance Details for tdock-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tdock 0.1.2
File Interpreter ABI Platform Actions
tdock-0.1.2-py3-none-any.whl Python 3 none any Details for tdock-0.1.2-py3-none-any.whl

Total release size: 61.6 kB

Release files / tdock-0.1.2.tar.gz

Download URL tdock-0.1.2.tar.gz
Size 31.6 kB
Tags Source
SHA-256 checksum
How to use checksums
51572817f138bcab07a490246252b26b20dcd3950e561cb72c382cc7b6b3334d
BLAKE2b-256 checksum
How to use checksums
56daaa06f97f96c0cc7a3bf9b91ba21431086c4f1422d865a015e6be4b1e5284
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.9

Release files / tdock-0.1.2-py3-none-any.whl

Download URL tdock-0.1.2-py3-none-any.whl
Size 29.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1e2f8ab9695f796815f0785c043d02a127ab4cab81e03624921d7c3c462d9612
BLAKE2b-256 checksum
How to use checksums
419909b2db2b786da69ab7072f9a800555d6eb122affdfc4c1dc89448053ed7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.9

Security for tdock 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page