Skip to content
v0.11.3 ·built with Rust

Monitor containers across every host

dtop streams live CPU, memory, network and disk metrics from local, SSH, TCP and TLS Docker daemons into a single table in your terminal.

$ brew install dtop
dtop · 3 hosts
What it does well

Nothing to deploy, nothing to configure

No agents on the machines you're watching, no collector, no account. Point dtop at a socket and it starts drawing.

Multi-host

Every host in one table

Local, SSH, TCP and TLS daemons side by side, sorted together, with a Host column when there's more than one. Over SSH, containers share a few pooled connections instead of one each, so 30 containers use 4.

local /var/run/docker.sock
ssh deploy@edge-01:2222
tcp 192.168.1.100:2375
tls ops@db-eu:2376
0
agents to deploy
3.8 MB
single binary
Live stats

The machine and its containers, together

CPU, memory, network and disk per container, smoothed so the numbers settle instead of flicker. A header adds the machine itself, local or read over SSH from the server's own /proc, next to what its containers add up to.

▂▃▅▆▇█▇▆▄▃▂▁▂▄▆▇█▇▅▄▃▂▁▂▃▅▆▇▆▄▃▂▁
System nas CPU 12.7% of 6 cores
Docker nas CPU 0.6% 16/16 running
■ 0–50 ■ 50–80 ■ 80+
Actions

Act on many containers at once

Mark containers with Space, a whole compose project with p, or everything listed with Ctrl+A, then start, stop, restart or remove them together. Remove asks twice, failures stay marked for a retry, and one summary tells you how it went.

7 containers, 3 selected (Enter for actions, Esc to clear)
shop-api shop
shop-worker shop
shop-redis shop
grafana monitoring
Restarted 3 containers
Native Rex support

Made for your terminal, not just inside it

dtop asks the terminal what it can do and uses it: Nerd Font icons, clickable names, a tab title that follows what you're looking at. In Rex it goes further, with a tab that tells you when something needs a look. In tmux and Rex, shells and logs open in their own panes.

dtop --panes --host ssh://user@nas

Native panes

tmux · Rex

With --panes, Shell and → open in a tmux or Rex pane beside the list, on any host dtop can reach, SSH included.

Tab status

Rex

The tab is flagged while a bulk action runs, when it finishes or fails, when a host drops, and when a container turns unhealthy.

App logos

Rex · Ghostty · kitty

Each container's image logo sits next to its name, drawn by the terminal itself.

Works over SSH

Everywhere

Run dtop on a server and it still reaches your local terminal: icons, logos, tab title and status travel through the SSH session.

Config

Write it down once, or let dtop do it

Hosts, filters and display settings can live in a YAML file. Or press Ctrl-S in the app and dtop saves your columns, sort and view for you — keys you set by hand are preserved.

Search order
  1. 1 ./config.yaml or ./config.yml, ./.dtop.yaml, ./.dtop.yml
  2. 2 ~/.config/dtop/config.yaml or ~/.config/dtop/config.yml
  3. 3 ~/.dtop.yaml or ~/.dtop.yml

First file found wins. Command-line flags override whatever the file says.

Hosts
# == Hosts ==
# Docker host(s) to connect to. You can specify multiple hosts to monitor
# them simultaneously.
# Possible values for host: local, ssh://user@host, tcp://host:port, tls://host:port
# Optional fields per host: name (display name), dozzle (URL), filter (list of Docker filters)
hosts:
  - host: local
  # - host: ssh://user@server1
  #   name: prod-1
  #   dozzle: https://dozzle.server1.com/
  #   filter:
  #     - status=running
  #     - label=environment=production
  # - host: tcp://192.168.1.100:2375
  # - host: tls://192.168.1.100:2376
Reference

Flags

From the dtop --help output in the README.

-c, --config <PATH>

Path to a config file to use instead of the default locations

-H, --host <HOST>

Docker host(s) to connect to. Can be specified multiple times.

--host local Connect to local Docker daemon / active Docker context
--host unix:///path/docker.sock Connect to a specific Unix socket
--host ssh://user@host Connect via SSH
--host ssh://user@host:2222 Connect via SSH with custom port
--host tcp://host:2375 Connect via TCP to remote Docker daemon
--host tls://host:2376 Connect via TLS
--host local --host ssh://user@server1 --host tls://server2:2376 Multiple hosts
-i, --icons <ICONS>

Icon style to use for the UI

--icons auto Nerd Font icons on terminals that ship them built in
--icons unicode Standard Unicode icons (works everywhere)
--icons nerd Nerd Font icons (requires Nerd Font installed)
--hyperlinks <MODE>

Render container names as clickable OSC 8 hyperlinks to Dozzle

--hyperlinks auto Enable on terminals known to support OSC 8 (default)
--hyperlinks always Always render links (use inside tmux with
--hyperlinks never Never render links
-f, --filter <FILTER>

Filter containers (can be specified multiple times)

--filter status=running
--filter name=nginx
--filter label=com.example.version=1.0
--filter ancestor=ubuntu:24.04
-a, --all

Show all containers (default shows only running containers)

--panes

Open Shell and Logs in a terminal pane beside dtop instead of taking over its screen. Applies inside tmux, or inside Rex with its CLI on PATH

-s, --sort <SORT>

Default sort field for container list

--sort uptime Sort by time since the container last started (default, newest first)
--sort name Sort by container name (alphabetically)
--sort cpu Sort by CPU usage (highest first)
--sort memory Sort by memory usage (highest first)

Hosts and filters combine — dtop --host local --host ssh://user@server -f status=running

Keys

Hands stay on the keyboard

A dozen bindings cover the whole surface. Press ? anywhere for the overlay.

↑↓ Move between containers
→ Stream this container's logs
← Back to the container list
Enter Start, stop, restart, remove
/ Search by name or ID
s Choose the sort field
c Show and reorder columns
a Include stopped containers
t Show or hide system stats
Space Select containers for bulk actions
Ctrl+A Select every listed container
p Select a whole compose project
Ctrl+S Save your preferences

Start watching in one command

macOS and Linux, Intel and ARM. No account, no telemetry.

$ brew install dtop