docktop

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 27, 2026 License: MIT

README ΒΆ

docktop

A fast, lightweight, and modern Terminal UI (TUI) for Docker, built with Go.

Manage and monitor your Docker with keyboard-driven ease.

docktop preview


Installation

Option 1: Download Pre-built Binary

Download the latest binary for your operating system (Linux, macOS, Windows) from the Releases page.

# Example for Linux (x86_64)
tar -xzf docktop_*_linux_amd64.tar.gz
sudo mv docktop /usr/local/bin/
Option 2: Using go install
go install github.com/xoaiPro235/docktop/cmd/docktop@latest
Option 3: Build from Source
git clone https://github.com/xoaiPro235/docktop.git
cd docktop
make build
./docktop

Configuration & Themes

docktop reads its configuration from ~/.config/docktop/config.yaml (or the equivalent OS config directory). If the file does not exist, docktop automatically creates one with default settings upon first launch.

Example ~/.config/docktop/config.yaml:
# docktop configuration file
# Location: ~/.config/docktop/config.yaml

# UI Theme:
# Available presets:
#   - tokyo-night : Default vibrant Tokyo Night / Neon aesthetic
#   - terminal    : Adaptive 16 ANSI colors (automatically matches your terminal emulator theme: Kitty, Alacritty, iTerm2, WezTerm)
#   - dracula     : Classic Dracula dark theme
#   - catppuccin  : Soothing Catppuccin Mocha theme
#   - nord        : Arctic, north-bluish palette
theme: "terminal"

# Docker Host:
# Optional Docker daemon endpoint or remote socket.
# host: "ssh://user@remote-vps:22"

Tip: Setting theme: "terminal" will make docktop automatically inherit whatever colors your terminal emulator (Kitty, Alacritty, iTerm2, WezTerm) is configured with!

Remote Docker / SSH: You can specify a remote Docker endpoint via -H / --host, the host config option, or DOCKER_HOST:

docktop -H ssh://user@remote-vps

πŸ™ Acknowledgements

docktop is inspired by and learns from amazing open-source projects:

  • btop by aristocratos – Visual inspiration for Braille graph resource monitoring and mirrored layouts.
  • lazydocker by Jesse Duffield – Workflow inspiration for container lifecycle management and compose tree structure.
  • Charmbracelet (Bubble Tea & Lipgloss) – The wonderful TUI framework and styling toolkit powering this project.

πŸ“„ License

This project is licensed under the MIT License.

Directories ΒΆ

Path Synopsis
cmd
docktop command
internal
tui
tui/components/container
Layout conceptsaand graph inspired by btop (https://github.com/aristocratos/btop).
Layout conceptsaand graph inspired by btop (https://github.com/aristocratos/btop).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL