---
url: https://dozzle.dev/guide/dtop.md
description: >-
  Install dtop, a terminal tool that shows your running Docker containers in
  real time over SSH, TCP or a local socket and opens Dozzle for logs.
---

# dtop

`dtop` is a command-line companion to Dozzle that gives you a real-time terminal view of the Docker containers running on your system. Think of it as a richer `docker ps` you can leave open in a tmux pane, and when you need the full log history, search, or charts, `dtop` lets you jump straight into Dozzle.

It connects to Docker hosts via `ssh`, `tcp`, or a local `unix socket`, making it well suited for the same multi-host setups Dozzle supports.

![dtop screenshot](https://github.com/amir20/dtop/raw/master/demo.gif)

## Installation

Install with Homebrew:

```bash
brew install dtop
```

Or run it via Docker without installing anything:

```bash
docker run -v /var/run/docker.sock:/var/run/docker.sock -it ghcr.io/amir20/dtop:latest
```

Full installation instructions can be found at [https://github.com/amir20/dtop](https://github.com/amir20/dtop?tab=readme-ov-file#installation).

## Scope

`dtop` is deliberately smaller than Dozzle. It covers the "what is running right now, and is anything on fire" question from a terminal, and hands off to Dozzle for everything that needs a browser: log history, search, SQL queries, and stat charts.

It is developed in its own repository and ships on its own schedule. Suggestions and bug reports belong at <https://github.com/amir20/dtop/issues>.