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: Fails to start on Python 3.9

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 tdock        # recommended: isolated, adds the tdock command
# or
uv tool install tdock
# or, inside a virtualenv / conda env
pip install tdock

On recent Debian/Ubuntu, a plain pip install into the system Python is blocked (externally-managed-environment); use pipx or uv tool instead.

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

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.1
File Size Uploaded Provenance Actions
tdock-0.1.1.tar.gz 31.0 kB Without provenance Details for tdock-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 60.6 kB

Release files / tdock-0.1.1.tar.gz

Download URL tdock-0.1.1.tar.gz
Size 31.0 kB
Tags Source
SHA-256 checksum
How to use checksums
b2cba31a28cae3c3c8d6f0d267f28331262a53b8c688d2c106fe4c6bd9a5af21
BLAKE2b-256 checksum
How to use checksums
549aba2d0e92862a59b302467349a1f0db76ae616b0a8979af085a043f0e9659
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.1-py3-none-any.whl

Download URL tdock-0.1.1-py3-none-any.whl
Size 29.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2bffbc898f903c375181e003e099d54ca883c875ff57aa72be3d7401c8a78c5c
BLAKE2b-256 checksum
How to use checksums
a893ab6ee1e88115ae27008cccefe2a1aae14b5cd1709d3d0aefe78ad39dfd31
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.1

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.1 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