How do I set up SSL for Doku?

Mount SSL certificate files (key.pem and cert.pem) when running the Docker container, as shown in the advanced setup example. This enables HTTPS access for secure communication.

Doku vs Portainer: which is better for disk monitoring?

Doku specializes in detailed, read-only disk usage tracking with a lightweight interface, while Portainer offers broader Docker management including disk info. Choose Doku for focused disk analytics without cleanup features.

How to adjust Doku's scan intervals to reduce CPU usage?

Use environment variables like SCAN_INTERVAL and SCAN_INTENSITY. Set SCAN_INTENSITY to 'light' and increase intervals to reduce scan frequency, balancing performance with monitoring needs.

Does Doku work with Docker Swarm?

Doku is primarily designed for single-host monitoring and may not natively support Docker Swarm's distributed nature. It can monitor the local node but lacks centralized views for the entire swarm.

Can Doku automatically delete old Docker images?

No, Doku is a read-only monitoring tool and does not perform any cleanup actions. You'll need to use Docker commands or other tools like docker prune for resource management.

How to mount the host filesystem safely with Doku?

Always use read-only (:ro) mounts for both the Docker socket and host root directory. This prevents modifications, and consider restricting paths if security is a concern in production.

Is Doku suitable for production environments?

Yes, with configurations like authentication and SSL, Doku can be used in production for disk monitoring. However, its lack of alerts and historical data means you might need additional tools for comprehensive oversight.

Open-Awesome

Doku

MITPythonv1.3.0

A lightweight web dashboard for monitoring Docker disk usage across images, containers, volumes, and storage layers.

Visit Website GitHub

446 stars19 forks0 contributors

What is Doku?

Doku is a lightweight web application that monitors Docker disk usage through a clean, intuitive interface. It tracks space consumed by images, containers, volumes, builder cache, overlay2 storage, logs, and bind mounts, helping users identify storage bottlenecks. The tool operates in read-only mode to ensure safety and requires minimal setup via Docker.

Target Audience

Developers, DevOps engineers, and system administrators who manage Docker environments and need visibility into disk space allocation across containers and images.

Value Proposition

Doku offers a simple, focused alternative to complex monitoring suites, providing real-time Docker disk insights with zero risk of data modification due to its read-only design and easy Docker-based deployment.

Overview

💽 Doku - Docker disk usage dashboard

Use Cases

Best For

Monitoring Docker disk usage in development or production environments
Identifying which containers or images are consuming excessive storage
Tracking overlay2 storage consumption, often the largest disk space consumer
Securely monitoring Docker hosts with read-only access requirements
Quickly deploying a lightweight disk analytics dashboard via Docker
Managing multi-architecture Docker setups (amd64/arm64)

Not Ideal For

Environments that require automated cleanup or pruning of Docker resources
Projects using non-Docker container runtimes like Podman or containerd
Teams needing comprehensive infrastructure monitoring with alerts and historical data analysis

Pros & Cons

Pros

Comprehensive Disk Tracking

Monitors all key Docker components including overlay2 storage, builder cache, and logs, as detailed in the features list for a complete view of disk usage.

Read-Only Safety

Operates with strict read-only mounts to the Docker socket and host filesystem, preventing any accidental modifications or deletions, ensuring zero risk to data.

Easy Docker Deployment

Can be launched with a single Docker run command, making setup quick and minimal, as shown in the quick start section.

Configurable Performance

Offers adjustable scan intervals and intensity levels (aggressive, normal, light) to balance monitoring accuracy with system resource usage, based on environment variables.

Cons

No Cleanup Capabilities

Purely a monitoring tool with no built-in functionality to remove unused images, containers, or volumes, requiring manual intervention for disk management.

Host Filesystem Dependency

Requires mounting the entire host root directory, which could pose security risks or compatibility issues in restricted or containerized environments.

Limited to Single Host

Designed for monitoring a single Docker host with no native support for clustered environments like Docker Swarm or Kubernetes, lacking distributed monitoring features.

External Command Reliance

By default uses the system 'du' command for disk calculations, which may fail or be unavailable in some minimal container setups, as indicated by the SCAN_USE_DU option.

Frequently Asked Questions

Related Projects

glances

Glances an Eye on your system. A top/htop alternative for GNU/Linux, BSD, macOS and Windows operating systems.

Analyzes resource usage and performance characteristics of running containers.

Stars19,408

Forks2,491

Last commit6 days ago

Checkmate

Checkmate is an open-source, self-hosted tool designed to track and monitor server hardware, uptime, response times, and incidents in real-time with beautiful visualizations. Don't be shy, join here: https://discord.com/invite/NAb6H3UTjK :)

Stars10,798

Forks1,195

Last commit22 hours ago

HertzBeat

An AI-powered next-generation open source real-time observability system.

Stars7,386

Forks1,329

Last commit5 hours ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub