# dtop

> Terminal UI for monitoring and managing Docker containers with real-time stats, log viewing, and keyboard-driven workflow

Stars: 39 · Categories: System

- Repository: https://github.com/StakeSquid/dtop
- Website: https://stakesquid.com
- Page: https://www.trmn.sh/tools/dtop

## Install

- PyPI: `pip install dtop`
- GitHub: `pip install git+https://github.com/StakeSquid/dtop.git`
- Install Script: `sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/StakeSquid/dtop/main/scripts/install.sh)"`

## Overview

dtop is a terminal user interface for Docker container management and monitoring. It provides real-time statistics including CPU, memory, network I/O, and disk I/O metrics through parallel streaming collection. The interface supports full container lifecycle operations including start, stop, pause, restart, shell execution, removal, and recreation with docker-compose support.

The tool features an advanced log viewer with search capabilities, filtering using AND/OR/NOT expressions, follow mode, time-range filtering, and export functionality. Container inspection is available in both tree and JSON views with expandable sections and value copying. All operations are keyboard-driven with comprehensive shortcuts, though mouse interaction is fully supported.

The interface includes customizable column layouts, theme presets, and persistent configuration stored in ~/.docker_tui.json. Users can adjust column widths, reordering, and responsive behavior based on terminal width. A legacy curses mode is available as fallback via the --legacy flag for environments where the default Textual UI may have compatibility issues.

The tool is designed for developers, DevOps engineers, and system administrators who frequently work with Docker containers and need efficient monitoring and management capabilities directly from the terminal.

### Installation

```bash
# via PyPI
pip install dtop
```

```bash
# via GitHub
pip install git+https://github.com/StakeSquid/dtop.git
```

```bash
# via Install Script
sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/StakeSquid/dtop/main/scripts/install.sh)"
```

![Main dtop interface showing container list](https://media.trmn.sh/cached/3c35f987785f98c161c26e347ce954ed64a0d90a4fe5d245cfb3bc21acfaf15f.png)

![Log viewer interface](https://media.trmn.sh/cached/343b362345d9d02f28aa6e0bf5f5c4b83a17c295fb2408ffb33b6dbde77e3b79.png)

![Container inspector view](https://media.trmn.sh/cached/2a154c1aeb431dd22d9e5ffb82c2a2d02e6000cbb401bfae473c9523e535ae94.png)

## Alternatives

- [g1c](https://www.trmn.sh/tools/g1c.md): Terminal UI for monitoring and managing Google Cloud VM instances with real-time updates and instance operations (Rust, 41 stars)
- [blueutil-tui](https://www.trmn.sh/tools/blueutil-tui.md): TUI for managing Bluetooth device connections on macOS using blueutil (53 stars)
- [zigfetch](https://www.trmn.sh/tools/zigfetch.md): A system information tool written in Zig that displays system details similar to neofetch/fastfetch (Zig, 55 stars)
- [ecscope](https://www.trmn.sh/tools/ecscope.md): TUI for monitoring AWS ECS services, tasks, and containers across multiple clusters and regions in a unified view. (Rust, 14 stars)
- [ssm](https://www.trmn.sh/tools/ssm.md): Terminal UI for managing and connecting to SSH hosts with vim-style navigation and tagging (Go, 114 stars)

## Guides

- [Best Docker TUIs](https://www.trmn.sh/best/docker-tuis): Compare lazydocker, ducker, dtop, dive and ctop: Docker TUIs for containers, Compose, logs, stats and image layer analysis.

---

Canonical: https://www.trmn.sh/tools/dtop