Anders Lehmann Pier 395bbf8244
Some checks failed
dashboard-pro-build / build (push) Has been cancelled
Update .gitea/workflows/docker-build.yml
2025-07-01 19:53:18 +00:00
2025-07-01 19:43:21 +00:00
2025-06-22 23:43:51 +02:00
2025-06-30 00:44:33 +00:00

🚀 Dokploy Dashboard Pro

Modern Docker container management dashboard that supplements your existing Dokploy setup with real-time monitoring and container controls.

Dokploy Dashboard Docker Next.js

Features

  • 🎮 Real Container Controls - Start, stop, restart containers with safety checks
  • 📊 Live Monitoring - Real-time CPU, memory, and network metrics
  • 🌐 Traefik Integration - Automatic domain detection from routing rules
  • 🔍 Smart Detection - Identifies Dokploy-managed vs user containers
  • 🎨 Modern UI - Beautiful glassmorphism design with smooth animations
  • 🔒 Safety First - Prevents stopping critical infrastructure (Dokploy/Traefik)
  • 📱 Responsive - Works perfectly on desktop and mobile

🏗️ Architecture

This dashboard supplements your existing Dokploy setup:

  • Reads containers via Docker API
  • Identifies services through Traefik labels
  • Provides additional monitoring and control
  • Does NOT replace Dokploy - works alongside it!

🚀 Quick Deploy with Dokploy

  1. Create New Project in your Dokploy dashboard
  2. Add ServiceDocker Compose
  3. Repository: https://github.com/AndersPier/dokploy-dashboard-pro.git
  4. Update domains in docker-compose.yml:
    labels:
      - "traefik.http.routers.dashboard.rule=Host(`dashboard.yourdomain.com`)"
    
  5. Deploy!

Option 2: Manual Docker Compose

# Clone the repository
git clone https://github.com/AndersPier/dokploy-dashboard-pro.git
cd dokploy-dashboard-pro

# Update your domain in docker-compose.yml
# Then deploy
docker-compose up -d

🔧 Configuration

Update Domain

Edit docker-compose.yml and change:

labels:
  - "traefik.http.routers.dashboard.rule=Host(`dashboard.yourdomain.com`)"

Replace dashboard.yourdomain.com with your actual domain.

Environment Variables

Variable Default Description
NODE_ENV production Runtime environment
PORT 3000 Application port

🎯 Container Detection

The dashboard automatically detects and categorizes containers:

  • 🟣 Platform (Dokploy) - Core platform services
  • 🟠 Proxy (Traefik) - Reverse proxy and load balancer
  • 🟢 Database (PostgreSQL, Redis, etc.) - Data services
  • Application - Your deployed apps

🛡️ Safety Features

  • Critical Service Protection: Prevents stopping Dokploy/Traefik
  • Confirmation Dialogs: Confirms destructive actions
  • Loading States: Visual feedback during operations
  • Error Handling: Clear error messages and recovery

📊 Monitoring

  • Real-time Stats: CPU, memory usage per container
  • Health Status: Visual indicators for container health
  • Uptime Tracking: Shows how long containers have been running
  • Domain Mapping: Lists all exposed domains via Traefik

🔗 Integration

Traefik Labels

Automatically reads domains from Traefik labels:

labels:
  - "traefik.http.routers.myapp.rule=Host(`app.example.com`)"

Dokploy Labels

Recognizes Dokploy metadata:

labels:
  - "dokploy.name=My Application"
  - "dokploy.environment=production"
  - "dokploy.project=main-site"

🚀 Next Features

  • 📋 Live Log Streaming - Real-time container logs
  • 📈 Resource Monitoring - Historical metrics and charts
  • 🔔 Alerts & Notifications - Custom alert rules
  • 📦 Deployment Pipeline - Visual deployment tracking

🧪 Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

📋 Requirements

  • Docker with API access
  • Existing Dokploy setup
  • Node.js 18+ (for development)

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

📄 License

MIT License - feel free to use this in your projects!

🆘 Support


Made with ❤️ for the Dokploy community

Description
Modern Docker container management dashboard for Dokploy - with real-time monitoring and container controls
Readme 61 KiB
Languages
JavaScript 98.3%
Dockerfile 0.9%
CSS 0.8%