Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.1.2 instead.
Reason given by maintainers: Missing license and author metadata

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

pipx install git+https://github.com/<user>/tdock.git
# or
uv tool install git+https://github.com/<user>/tdock.git

Update with pipx upgrade tdock (or uv tool upgrade 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)

Metadata

Release files for tdock 0.1.0

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

Built distribution (wheel)

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

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

Download URL tdock-0.1.0-py3-none-any.whl
Size 28.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2ce3cab9e97a4b2961de09741148a2b6aa5eb4dd25aee4affffb16a25012f061
BLAKE2b-256 checksum
How to use checksums
fc081b7a9b3e17c0aeadc7138df682e8cf77d217923accd02b3535aecaac4ad7
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.0

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.0 This release

1 release file 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