---
title: "Homarr Docker Stats Widget — Container Resource Monitoring"
aliases: [homarr-docker-containers, docker-stats-widget]
tags: [homelab, homarr, docker, widgets, monitoring]
sources: [raw/Docker stats  Homarr documentation.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

The Docker Stats widget displays real-time resource usage for all Docker containers and provides basic container lifecycle controls directly from the Homarr dashboard.

> **Admin only** — this widget requires administrator privileges.

## Capabilities

### Resource Monitoring
- Displays CPU, memory, and status metrics per container
- Updates via background tasks (see [[wiki/homelab/homarr-tasks|Homarr Tasks]])

### Container Controls
- **Start** — click the play icon
- **Stop** — click the stop icon
- **Restart** — click the refresh icon

## Integration Requirement

Requires a **Docker integration** configured in Homarr.

- Docker is the only supported integration for this widget
- Set up the connection first via [[wiki/homelab/homarr-integrations|Homarr Integrations]]
- Docker integration details: `https://homarr.dev/docs/integrations/docker`

## Setup

Add via the Widgets section — see [[wiki/homelab/homarr-boards|Homarr Boards]] for the general widget embedding workflow (`Settings → Widgets → Add widget`).

## Key Takeaways

- Combines monitoring + management in one widget: view stats and control containers without opening Portainer or a terminal
- Admin-only widget — regular users cannot see or interact with it
- Depends on a working Docker integration; widget won't populate without one
- Controls are per-container (start / stop / restart) — not bulk operations
- For background polling frequency, adjust via [[wiki/homelab/homarr-tasks|Homarr Tasks]]

## Sources

- `raw/Docker stats  Homarr documentation.md` — Homarr v1.59.2 official docs
