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 runcommand 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
dockerCLI and access to a Docker daemon (rootful or rootless) - Python 3.9+
nvidia-smifor 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
--mountso a missing host path fails instead of silently creating an empty directory. - DooD mounts the Docker socket, the
dockerbinary 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.