# DockMon
A comprehensive Docker container monitoring and management platform with real-time monitoring, intelligent auto-restart, multi-channel alerting, and complete event logging.
## Key Features
- **Multi-Host Monitoring** - Monitor containers across unlimited Docker hosts (local and remote)
- **Real-Time Statistics** - Live CPU, memory, network, and disk I/O metrics for hosts and containers
- **Real-Time Container Logs** - View logs from multiple containers simultaneously with live updates
- **Event Viewer** - Comprehensive audit trail with filtering, search, and real-time updates
- **Intelligent Auto-Restart** - Per-container auto-restart with configurable retry logic
- **Advanced Alerting** - Discord, Slack, Telegram, Pushover, Gotify, SMTP with customizable templates
- **Real-Time Dashboard** - Drag-and-drop customizable widgets with WebSocket updates
- **Secure by Design** - Session-based auth, rate limiting, mTLS for remote hosts
- **Mobile-Friendly** - Responsive design that works seamlessly on all devices
## Documentation
- **[Complete User Guide](https://github.com/darthnorse/dockmon/wiki)** - Full documentation
- **[Quick Start](https://github.com/darthnorse/dockmon/wiki/Quick-Start)** - Get started in 5 minutes
- **[Installation](https://github.com/darthnorse/dockmon/wiki/Installation)** - Docker, unRAID, Synology, QNAP
- **[Configuration](https://github.com/darthnorse/dockmon/wiki/Notifications)** - Alerts, notifications, settings
- **[Security](https://github.com/darthnorse/dockmon/wiki/Security-Guide)** - Best practices and mTLS setup
- **[Remote Monitoring](https://github.com/darthnorse/dockmon/wiki/Remote-Docker-Setup)** - Monitor remote Docker hosts
- **[Event Viewer](https://github.com/darthnorse/dockmon/wiki/Event-Viewer)** - Comprehensive audit trail with filtering
- **[Container Logs](https://github.com/darthnorse/dockmon/wiki/Container-Logs)** - Real-time multi-container log viewer
- **[API Reference](https://github.com/darthnorse/dockmon/wiki/API-Reference)** - REST and WebSocket APIs
- **[FAQ](https://github.com/darthnorse/dockmon/wiki/FAQ)** - Frequently asked questions
- **[Troubleshooting](https://github.com/darthnorse/dockmon/wiki/Troubleshooting)** - Common issues
## Use Cases
### Home Lab
- Monitor all your Docker containers in one place
- Get notified when critical services go down
- Automatically restart failed containers
- Track container events and changes
### Small Business
- Centralized monitoring across multiple servers
- Multi-channel alerting (Discord, Slack, Telegram, Pushover, Gotify, SMTP)
- Schedule maintenance windows with blackout periods
- Audit trail of all container operations
### Development Teams
- Monitor dev, staging, and production environments
- Quick container management (start, stop, restart, logs)
- Test notifications before deploying to production
- Share monitoring dashboard with team
## Support & Community
- **[Report Issues](https://github.com/darthnorse/dockmon/issues)** - Found a bug?
- **[Discussions](https://github.com/darthnorse/dockmon/discussions)** - Ask questions, share ideas
- **[Wiki](https://github.com/darthnorse/dockmon/wiki)** - Complete documentation
- **[Star on GitHub](https://github.com/darthnorse/dockmon)** - Show your support!
## Roadmap
### Completed (v1.0)
- [x] Full backend API with FastAPI
- [x] WebSocket real-time updates
- [x] Multi-channel notifications
- [x] Comprehensive event logging
- [x] Event log viewer with filtering and search
- [x] Real-time container logs viewer (multi-container support)
- [x] Drag-and-drop dashboard
- [x] Auto-restart with retry logic
### Completed (v1.1)
- [x] Real-time performance metrics (CPU, memory, network, disk I/O)
- [x] Host-level and container-level statistics
- [x] TLS/mTLS support for secure remote Docker connections
- [x] Optimized streaming architecture with Go backend
### Planned (v1.5+)
- [ ] Performance metrics dashboard with historical graphs
- [ ] Container auto-update feature with version tracking
- [ ] Configuration export/import
- [ ] Automatic Proxmox LXC installation script
See the [full roadmap](https://github.com/darthnorse/dockmon/wiki/Roadmap) for details.
## Contributing
Contributions are welcome! Here's how you can help:
- Report bugs via [GitHub Issues](https://github.com/darthnorse/dockmon/issues)
- Suggest features in [Discussions](https://github.com/darthnorse/dockmon/discussions)
- Improve documentation (edit the [Wiki](https://github.com/darthnorse/dockmon/wiki))
- Submit pull requests (see [Contributing Guide](https://github.com/darthnorse/dockmon/wiki/Contributing))
## Development
Want to contribute code or run DockMon in development mode?
See [Development Setup](https://github.com/darthnorse/dockmon/wiki/Development-Setup) for:
- Local development environment setup
- Architecture overview
- Running tests
- Building from source
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Author
Created by [darthnorse](https://github.com/darthnorse)
## Acknowledgments
This project has been developed with **vibe coding** and **AI assistance** using Claude Code. The codebase includes clean, well-documented code with proper error handling, comprehensive testing considerations, modern async/await patterns, robust database design, and production-ready deployment configurations.
---
If DockMon helps you, please consider giving it a star!
Documentation •
Issues •
Discussions