docker-tui

⚡ Install in one line

Prebuilt static binaries — no Go, no dependencies. Just a running Docker daemon.

🐧 Linux · 🍎 macOS

curl -fsSL https://raw.githubusercontent.com/Akib558/docker-tui/main/scripts/install.sh | sh

🪟 Windows (PowerShell)

irm https://raw.githubusercontent.com/Akib558/docker-tui/main/scripts/install.ps1 | iex

🐹 With Go

go install github.com/Akib558/docker-tui@latest

Then just run:

docker-tui

_{The one-line installers pull the latest release from GitHub. See Installation for manual downloads and building from source.}

Why docker-tui

Docker's CLI is powerful, but day-to-day container work means repeating the same status checks, log tails, restarts, and inspects. docker-tui folds all of that into one responsive, keyboard-driven screen that feels right at home over SSH.

Reach for it when you want to:

• See container status, ports, CPU, memory, and Docker host health at a glance.
• Jump from a container list into details, logs, environment, resource history, or a shell.
• Follow logs from one or many containers with stable color labels and filtering.
• Start, stop, restart, kill, pause, and remove containers without leaving the keyboard.
• Manage images, volumes, and networks alongside containers in the same interface.
• Keep a single lightweight binary that works great in terminal-first and SSH workflows.

Features

🖥️ Live container dashboard

• Container list ordered running-first, then by name — active workloads stay on top.
• Live status strip: running / paused / stopped / created counts, plus last-refresh age.
• Inline CPU % and MEM % bars per container, color-graded green → amber → red.
• Host memory and load overview (Linux).
• Persistent CPU/MEM sparklines cached to disk, so short restarts don't erase context.
• Container uptime, restart-count, and health-check status.
• Responsive columns — NAME/STATUS on narrow terminals; IMAGE, CPU, MEM, PORTS, ID, and I/O added as the window widens.
• Adjustable refresh interval, manual refresh, and sort cycling (name → state → CPU → memory → image).

📜 Logs built for real work

• Per-container Logs tab in the detail view.
• Centralized logs across selected containers, or all running containers when nothing is selected.
• Stable per-container color tags so interleaved streams stay readable.
• Severity coloring out of the box (ERROR / WARN / INFO / DEBUG) plus configurable highlight patterns.
• Timestamp-aware ordering, text/regex filtering, and follow mode that pauses when you scroll up.
• Copy a line (y) or export the whole buffer to a file (E).

🔍 Deep container inspection

Seven tabs per container — no more piping docker inspect through jq:

• Info — identity, runtime, resource limits, ports, mounts, networks, and compose labels.
• Resources — CPU/memory history graphs.
• Environment — environment variables.
• Logs — the focused per-container log view.
• Terminal — an embedded shell session, in-app.
• Diff — filesystem changes on the container's writable layer.
• Processes — running processes inside the container (docker top).

⚡ Operational controls

• Start, stop, restart, kill, and pause/unpause — one container or a multi-selected group.
• Remove containers, or run docker system prune with a confirmation step.
• Open an external docker exec -it session, or use the embedded terminal tab.
• Command palette (:) for fuzzy access to any action by name.

📦 Full Docker inventory

• Images — list, pull, remove, and prune dangling images.
• Volumes — list, remove, prune orphaned volumes, filter, and multi-select.
• Networks — list, remove, filter, and multi-select.
• Events — live stream of Docker daemon events (container, image, network, and volume activity).

🔔 Notifications & 🎨 ergonomics

• Persistent notification center (N) for every action result and connection event.
• CPU/memory threshold alerts.
• Ten built-in themes, switchable at runtime (t).
• Keyboard-first navigation with mouse support; responsive layout for any terminal size.
• JSON config for refresh interval, alert thresholds, theme, and stable log colors.

Screenshots

Centralized logs — merge, color-tag, filter, and follow many containers at once

Detail view — seven tabs of everything docker inspect knows

Installation

One-line installers (recommended)

See Install in one line above. The scripts detect your OS and architecture, download the matching release archive, and drop the binary onto your PATH (~/.local/bin on Linux/macOS, %LOCALAPPDATA%\docker-tui\bin on Windows).

Pre-built binaries

Download an archive for your platform from GitHub Releases (Linux, macOS, and Windows for amd64 and arm64), extract it, and place the docker-tui binary somewhere on your PATH.

Go install

go install github.com/Akib558/docker-tui@latest

Build from source

git clone https://github.com/Akib558/docker-tui.git
cd docker-tui
make build
./docker-tui

Install the locally built binary into your Go bin directory:

make install

Requirements

• Docker daemon running and reachable through the local socket or DOCKER_HOST.
• Terminal with 256-color support.
• Go 1.25 or newer when building from source.

Host memory and load metrics are Linux-specific. Core Docker workflows work on all supported platforms whenever Docker is reachable.

Quick start

docker-tui

1. Move through containers with j / k or arrow keys.
2. Press enter to inspect the selected container.
3. Use tab to move through detail tabs.
4. Press L from the list to open centralized logs.
5. Press / to filter containers or logs.
6. Press s, R, or d to start/stop, restart, or remove containers.
7. Press : to open the command palette, or ? for the full keyboard reference.
8. Press q to quit.

Key bindings

Common

Container list

Detail view

Centralized logs

Log detail modal

Opened from centralized logs or the container Logs tab with enter. On wide terminals the modal splits into a line list (left) and message body (right); on narrow terminals it collapses to a single pane.

Images

Volumes

Networks

Notification center

Events

Configuration

Config file: ~/.config/docker-tui/config.json

{
  "theme": "dark-green",
  "refresh_seconds": 3,
  "alert_cpu": 80.0,
  "alert_mem": 80.0,
  "container_colors": {
    "api": "#00E676",
    "worker": "#7AA2F7"
  }
}

Runtime history cache: ~/.cache/docker-tui/history.json

Themes

dark-green, dracula, nord, gruvbox, tokyo-night,
catppuccin-mocha, catppuccin-latte, rose-pine, ayu-dark, monokai

Switch themes inside the app with t, select with j / k, then press enter.

Development

make build        # build ./docker-tui
make run          # run from source
make test         # run unit tests
make lint         # run golangci-lint
make coverage     # write coverage.out and coverage.html

Project layout:

config/    Theme definitions and JSON config persistence
docker/    Docker SDK wrapper: containers, images, volumes, networks, events, logs, stats, host metrics
ui/        Bubble Tea model, commands, views, rendering core, themes, dialogs, and helpers
scripts/   Cross-platform install scripts

The CI pipeline runs go vet, race-enabled tests, cross-platform builds, and golangci-lint.

Contributing

Contributions are welcome. Keep pull requests focused, include tests for new behavior, and run the local checks before submitting. See CONTRIBUTING.md.

Security

Please do not open public issues for vulnerabilities. Follow SECURITY.md for responsible disclosure.

License

Licensed under the MIT License. Built with Bubble Tea and Lip Gloss.

_{Not affiliated with Docker, Inc.}