tutanck / doggy

Minimal TUI (Terminal User Interface) for Docker

Doggy

Minimal TUI interface for Docker

Preview

Check a preview of the TUI:

How to use?

Using the releases

You can download one of the binary from the release page

• https://github.com/pyaillet/doggy/releases/latest

Build it on your own:

• Install Rust (see here)
• Build the tool: cargo build --release
• Launch it: ./target/release/doggy

Usage

Docker connection

By default doggy will try the following in order:

1. Check for existence of the environment variables DOCKER_HOST and DOCKER_CERT_PATH, if both are defined it will try to connect to the address in the DOCKER_HOST variable and use ca.pem, cert.pem and key.pem in DOCKER_CERT_PATH to establish a secure connection to the docker daemon.
2. Check for existence of the environment variables DOCKER_HOST, if only this one is defined it will try to connect to the address in the DOCKER_HOST variable to establish an insecure connection to the docker daemon.
3. If the variables are not defined, it will connect to the local socket unix:///var/run/docker.sock

Key bindings

• Display help screen: ?
• Change view: : and resource name (containers, images, networks, volumes)
• Container view:
  • Show/hide stopped containers: a
  • Launch /bin/bash in the container: s
  • Launch a custom command in the container: S
  • Show container logs: l
• Sort by columns: F[1234]
• Inspect resource: i
• Delete a resource: Ctrl+d
• Browse lists:
  • Up: ↑ or j
  • Down: ↓ or k
• Previous view: Esc

What's working? (on the main branch)

• List containers
• Display the stopped containers
• Filter the container list
• Inspect containers
• View container logs
• Exec /bin/bash in a container
• Delete containers (running or stopped)
• List images
• Inspect image
• Filter the image list
• Delete images (not used by any container)
• List networks
• Inspect network
• Delete network
• List volumes
• Inspect volume
• Delete volume