Docker Monitor
An Omarchy Quattro bar widget for monitoring Docker containers.
Features
- Compose project grouping — containers are organized by their Docker Compose project with collapsible headers
- Live stats — CPU and memory usage for each running container
- Container actions — start, stop, restart, and unpause containers directly from the panel
- Log viewer — view recent container logs with timestamps
- Desktop notifications — alerts when containers stop, become unhealthy, or start back up
- Configurable polling — adjustable refresh interval (default 10s)
Log Viewer
Install
omarchy plugin add https://github.com/djjeane/omarchy-docker-plugin.git
Remove
omarchy plugin remove djjeane.docker-monitor
Configuration
Available settings in shell.json:
| Setting | Type | Default | Description |
|---|---|---|---|
pollIntervalSec |
integer | 10 | Seconds between data refreshes (5–300) |
showStoppedContainers |
boolean | true | Show stopped/exited containers |
notificationsEnabled |
boolean | true | Desktop notifications on state changes |
logLines |
integer | 100 | Number of log lines to display (25–500) |
Example bar layout entry:
{
"id": "djjeane.docker-monitor",
"pollIntervalSec": 15,
"notificationsEnabled": true
}
Keyboard shortcuts
| Key | List view | Log view |
|---|---|---|
r |
Refresh containers | Reload logs |
b |
— | Back to list |
esc |
Close panel | Back to list |
IPC
omarchy-shell shell toggle djjeane.docker-monitor
omarchy-shell shell summon djjeane.docker-monitor
omarchy-shell shell hide djjeane.docker-monitor
License
MIT
Requirements
- Docker CLI (
docker) accessible to the current user - Python 3 (for the data collection script)
notify-send(for desktop notifications)