Skip to content
AndreyJVMPublic

About

A fast, lightweight terminal TUI monitor for Host, Docker, Compose, and Swarm. Быстрый и легковесный терминальный TUI-монитор для хоста, Docker, Compose и Swarm.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Dockpulse

CI Release Go Version License: MIT Platform

A fast, lightweight terminal TUI monitor for Host, Docker, Compose, and Swarm.
Быстрый и легковесный терминальный TUI-монитор для хоста, Docker, Compose и Swarm.

English • Русский


English

Key Features

  • Host Metrics: Real-time CPU usage, core counts, RAM, sparkline trend graphs, disk mount points, network traffic (RX/TX), uptime, and top resource-consuming processes.
  • Docker Containers:
    • Live CPU% and memory stats with dynamic color coding.
    • Interactive sorting by CPU%, RAM, Name, or Status (s, o).
    • Live Network I/O (RX/TX) and Block I/O (Read/Write) metrics in details panel and inspect modal.
    • Healthcheck statuses ([healthy], [unhealthy], [starting]).
    • Search & filter by name, image, ID, or health status (/).
    • Logs viewer with scroll support (L).
    • Detailed container inspection modal (Enter / I).
    • Interactive shell session (E — /bin/bash or /bin/sh) inside container.
    • Power control: Start / Stop (S), Restart (P), Force Kill (K — SIGKILL).
    • Safe container removal with confirmation (x, d).
    • Docker System Prune modal (C) with disk reclaim estimates and confirmation.
    • Socket support: Docker daemon, Rootless Docker, Docker Desktop (macOS), and Podman (<2 ms latency).
  • Docker Compose: Automatic project/service grouping, aggregated stack health, live stack logs (L), service control (U / S / P), and stack teardown (D / down) with confirmation.
  • Docker Swarm: Cluster node roles (Leader, Manager, Worker), service listings, replica counts with degradation highlights, and live service logs (L).
  • Bilingual Interface (i18n): English and Russian language support with automatic locale detection (LANG, LC_*) and --lang flag.
  • Zero Dependencies: Standalone binary (<12 MB) with zero external runtime dependencies. Runs on Linux and macOS.

Installation

Pre-built .deb Package (Debian / Ubuntu / Linux Mint)

# AMD64 (x86_64)
wget https://github.com/AndreyJVM/dockpulse/releases/latest/download/dockpulse_0.7.4_amd64.deb
sudo dpkg -i dockpulse_0.7.4_amd64.deb

# ARM64
wget https://github.com/AndreyJVM/dockpulse/releases/latest/download/dockpulse_0.7.4_arm64.deb
sudo dpkg -i dockpulse_0.7.4_arm64.deb

Pre-built Binaries (Linux / macOS)

Download the latest archive from Releases:

# Linux AMD64
tar -xzf dockpulse_v0.7.4_linux_amd64.tar.gz
./dockpulse

# macOS (Apple Silicon)
tar -xzf dockpulse_v0.7.4_darwin_arm64.tar.gz
./dockpulse

Build from Source (Go 1.21+)

git clone https://github.com/AndreyJVM/dockpulse.git
cd dockpulse
make build
./dockpulse

Command-line Options

Usage:
  dockpulse [options]

Options:
  -i, --interval <duration>  Auto-refresh interval (default: 2s, e.g., 1s, 500ms)
  -t, --tab <1-4>            Initial active tab (1: Host, 2: Docker, 3: Compose, 4: Swarm) (default: 1)
  -l, --lang <en|ru>         Interface language: en or ru (default: auto-detected)
  -v, --version              Show version information
  -h, --help                 Show help message

Hotkeys

Key Action
1..4 / Tab / ←/→ Switch tabs (Host, Docker, Compose, Swarm)
r, R Force immediate refresh
↑ / ↓ (or k / j) Navigate rows / select items
/ Search & filter (Esc to clear)
s, S, o, O Sort containers (CPU, Memory, Name, Status)
L View logs (scroll with ↑/↓/PgUp/PgDn)
Enter / I Inspect container (details, mounts, network, ports, health)
E Attach interactive shell (/bin/bash or /bin/sh)
S Start / Stop container or Compose stack
P Restart container or Compose stack
K Force kill (SIGKILL) container
x, d Remove container (with confirmation)
U Start Compose stack
D Compose down (docker compose down) with confirmation
C Docker system prune (cleanup unused resources)
? Toggle help / hotkey shortcuts modal
q / Esc / Ctrl+C Quit application

Русский

Возможности

  • Метрики хоста: Использование процессора, число ядер, оперативная память, спарклайн-графики трендов, точки монтирования дисков, сетевой трафик (RX/TX), аптайм и топ ресурсоемких процессов.
  • Docker-контейнеры:
    • Мониторинг CPU% и RAM для каждого контейнера с цветовой индикацией.
    • Интерактивная сортировка по CPU%, RAM, имени или статусу (s, o).
    • Метрики Network I/O (RX/TX) и Block I/O (чтение/запись) в панели деталей и окне инспекции.
    • Статусы Healthcheck ([healthy], [unhealthy], [starting]).
    • Поиск и фильтрация по имени, образу, ID или статусу здоровья (/).
    • Встроенный просмотрщик логов с поддержкой прокрутки (L).
    • Детальная инспекция контейнера (Enter / I).
    • Подключение к интерактивному шеллу (E — /bin/bash или /bin/sh) внутри контейнера.
    • Управление питанием: Старт / Остановка (S), Перезапуск (P), Принудительное завершение (K — SIGKILL).
    • Безопасное удаление контейнера с подтверждением (x, d).
    • Модальное окно очистки ресурсов Docker (System Prune) (C) с оценкой освобождаемого места.
    • Поддержка сокетов: Docker daemon, Rootless Docker, Docker Desktop (macOS) и Podman (отклик <2 мс).
  • Docker Compose: Автоматическая группировка проектов/сервисов, сводный статус здоровья, просмотр логов проекта (L), управление сервисами (U / S / P) и сворачивание стека (D / down) с подтверждением.
  • Docker Swarm: Роли узлов кластера (Leader, Manager, Worker), список служб, статус реплик с цветовой индикацией сбоев и логи сервисов (L).
  • Двуязычный интерфейс (i18n): Русская и английская локализация с автоопределением языка (LANG, LC_*) и ключом --lang.
  • Без внешних зависимостей: Автономный бинарник (<12 МБ) без сторонних рантайм-зависимостей. Работает на Linux и macOS.

Установка

Установка .deb пакета (Debian / Ubuntu / Linux Mint)

# AMD64 (x86_64)
wget https://github.com/AndreyJVM/dockpulse/releases/latest/download/dockpulse_0.7.4_amd64.deb
sudo dpkg -i dockpulse_0.7.4_amd64.deb

# ARM64
wget https://github.com/AndreyJVM/dockpulse/releases/latest/download/dockpulse_0.7.4_arm64.deb
sudo dpkg -i dockpulse_0.7.4_arm64.deb

Готовые бинарные файлы (Linux / macOS)

Скачайте архив последней версии со страницы Releases:

# Linux AMD64
tar -xzf dockpulse_v0.7.4_linux_amd64.tar.gz
./dockpulse

# macOS (Apple Silicon)
tar -xzf dockpulse_v0.7.4_darwin_arm64.tar.gz
./dockpulse

Сборка из исходников (Go 1.21+)

git clone https://github.com/AndreyJVM/dockpulse.git
cd dockpulse
make build
./dockpulse

Параметры командной строки

Использование:
  dockpulse [опции]

Опции:
  -i, --interval <duration>  Интервал автообновления (по умолчанию: 2s, например: 1s, 500ms)
  -t, --tab <1-4>            Начальная вкладка (1: Host, 2: Docker, 3: Compose, 4: Swarm) (по умолчанию: 1)
  -l, --lang <en|ru>         Язык интерфейса: en или ru (по умолчанию: автоопределение)
  -v, --version              Показать версию программы
  -h, --help                 Показать справку

Горячие клавиши

Клавиша Действие
1..4 / Tab / ←/→ Переключение вкладок (Host, Docker, Compose, Swarm)
r, R Немедленное обновление данных
↑ / ↓ (или k / j) Навигация по строкам / выбор элементов
/ Поиск и фильтрация (Esc для сброса)
s, S, o, O Сортировка контейнеров (CPU, Память, Имя, Статус)
L Просмотр логов (прокрутка ↑/↓/PgUp/PgDn)
Enter / I Инспекция контейнера (детали, тома, сеть, порты, Healthcheck)
E Подключение к интерактивному шеллу (/bin/bash или /bin/sh)
S Старт / Остановка контейнера или стека Compose
P Перезапуск контейнера или стека Compose
K Принудительное завершение (SIGKILL) контейнера
x, d Удаление контейнера (с подтверждением)
U Запуск стека Compose
D Сворачивание стека Compose (docker compose down) с подтверждением
C Очистка неиспользуемых ресурсов (Docker System Prune)
? Окно справки по горячим клавишам
q / Esc / Ctrl+C Выход из приложения

Screenshots / Скриншоты

Place real UI screenshots in docs/screenshots/.
Скриншоты интерфейса размещаются в каталоге docs/screenshots/.

About

A fast, lightweight terminal TUI monitor for Host, Docker, Compose, and Swarm. Быстрый и легковесный терминальный TUI-монитор для хоста, Docker, Compose и Swarm.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages