How do I change the default admin password in Dockprom?

Update the ADMIN_PASSWORD environment variable, generate a new hash for Caddy using the docker run command provided in the README, and modify the docker-compose.yml file accordingly to ensure security.

Can Dockprom monitor multiple Docker hosts?

Dockprom is designed for single-host deployment via Docker Compose; for multi-host monitoring, you need to manually set up additional NodeExporters and configure Prometheus to scrape them, which isn't automated.

Dockprom vs Prometheus Operator: which is better for Kubernetes?

Use Prometheus Operator for Kubernetes-native monitoring with automated management and scalability, while Dockprom is ideal for simple Docker environments where ease of deployment outweighs cloud-native features.

How to add custom metrics to Dockprom?

Push custom metrics using the included Pushgateway by sending data via curl commands, as described in the 'Sending metrics to the Pushgateway' section, but note this requires manual integration for batch jobs.

Is Dockprom suitable for production use?

Yes, with proper security configurations like updating default credentials and setting up reliable alerting, but be cautious of its single-host focus and potential need for manual tweaks in larger setups.

How to update Grafana or other components in Dockprom?

Update image tags in docker-compose.yml, but check the README for version-specific issues like Grafana user ID changes, which may require additional commands or permission adjustments.

Open-Awesome

dockprom

MITv9.2.0

A Docker monitoring stack with Prometheus, Grafana, cAdvisor, NodeExporter, and AlertManager for hosts and containers.

GitHub

6.5k stars1.8k forks0 contributors

What is dockprom?

Dockprom is a Docker monitoring stack that bundles Prometheus, Grafana, cAdvisor, NodeExporter, and AlertManager into a single, easy-to-deploy solution. It solves the problem of setting up comprehensive monitoring for Docker hosts and containers by providing pre-configured dashboards, alert rules, and a unified deployment via Docker Compose.

Target Audience

DevOps engineers, SREs, and developers who need to monitor Docker-based infrastructure and want a ready-to-use, self-hosted observability stack.

Value Proposition

Developers choose Dockprom because it eliminates the complexity of manually integrating multiple monitoring tools, offers production-ready dashboards and alerts out of the box, and can be deployed quickly with minimal configuration.

Overview

Docker hosts and containers monitoring with Prometheus, Grafana, cAdvisor, NodeExporter and AlertManager

Use Cases

Best For

Monitoring Docker host resource usage (CPU, memory, storage, network)
Tracking performance metrics for individual Docker containers
Setting up alerting for service downtime or resource thresholds
Self-hosting a Prometheus and Grafana stack for Docker environments
Visualizing infrastructure metrics with pre-built Grafana dashboards
Deploying a complete observability solution via Docker Compose

Not Ideal For

Environments using Kubernetes or other container orchestrators beyond Docker
Teams requiring highly customized monitoring dashboards and alert rules without manual JSON editing
Large-scale deployments where Docker Compose may not provide necessary scalability and high availability
Projects where minimal resource overhead is critical, as the full stack includes multiple containers

Pros & Cons

Pros

Integrated Monitoring Stack

Combines Prometheus, Grafana, cAdvisor, NodeExporter, and AlertManager in a single Docker Compose deployment, eliminating the need for manual integration as shown in the install section.

Pre-configured Dashboards

Includes Grafana dashboards for Docker host metrics, container performance, and monitoring services, ready to use out of the box with screenshots and descriptions in the README.

Easy Deployment

Deploys with a simple Docker Compose command and minimal environment variables, making it quick to set up for Docker environments without complex configuration.

Built-in Alerting

Comes with predefined alert rules for common issues like service downtime and high resource usage, configurable via the alert.rules file as detailed in the README.

Cons

Manual Dashboard Customization

Customizing dashboards requires editing Grafana JSON files directly, such as changing fstype values for storage graphs, which is error-prone and not user-friendly.

Docker-Only Limitation

Tailored specifically for Docker monitoring, so it lacks native support for other platforms like Kubernetes without significant modifications, limiting its versatility.

Security Configuration Overhead

Caddy v2 mandates password hashes instead of plaintext, adding an extra step for setup and updates, as detailed in the updating section, which can be cumbersome.

Frequently Asked Questions

Related Projects

cAdvisor

Analyzes resource usage and performance characteristics of running containers.

Stars19,075

Forks2,466

Last commit8 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 :)

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

Stars7,178

Forks1,268

Last commit3 days ago

Logspout

Log routing for Docker container logs

Stars4,697

Forks665

Last commit2 years 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