🐳 Dockpit

A modern, beautiful Docker Dashboard for managing containers, images, and volumes with a premium glassmorphism UI.

---

✨ Features

📦 Containers

• View all containers with real-time status
• Start, stop, restart, pause, unpause containers
• Real-time CPU & memory usage stats
• Live log streaming with terminal view
• Interactive shell (exec) access
• Rename and delete containers
• Search and filter by status

🖼️ Images

• Browse all Docker images
• Run containers from images with custom arguments
• Delete unused images
• View image tags, size, and creation date

💾 Volumes

• List all Docker volumes
• Create new volumes
• Delete volumes with confirmation
• View mountpoint and driver info

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• Docker running on your machine
• pnpm (recommended) or npm

Installation

# Clone the repository
git clone https://github.com/yourusername/dockpit.git
cd dockpit

# Install dependencies
pnpm install

# Start development server
pnpm run dev

Open http://localhost:5173 in your browser.

Production Build

# Build the client
cd client && pnpm run build && cd ..

# Start the server
node bin/cli.js

---

🛠️ Tech Stack

Backend

• Fastify - Fast and low overhead web framework
• Dockerode - Docker Remote API bindings
• Socket.io - Real-time bidirectional communication

Frontend

• React 18 - UI library
• Vite - Next generation frontend tooling
• Tailwind CSS - Utility-first CSS framework
• Lucide React - Beautiful icons
• XTerm.js - Terminal emulator

---

📁 Project Structure

dockpit/
├── bin/
│   └── cli.js           # CLI entry point
├── server/
│   ├── index.js         # Fastify server
│   ├── docker-service.js # Docker API wrapper
│   ├── socket-handler.js # Socket.io handlers
│   └── routes/
│       ├── containers.js
│       ├── images.js
│       └── volumes.js
├── client/
│   ├── src/
│   │   ├── App.jsx
│   │   ├── components/
│   │   ├── hooks/
│   │   └── services/
│   └── index.html
└── package.json

---

🎨 UI Features

• Glassmorphism Design - Modern frosted glass effects
• Dark Theme - Easy on the eyes
• Animated Gradients - Subtle hover animations
• Real-time Updates - Socket.io powered live data
• Responsive Layout - Works on all screen sizes

---

📝 API Endpoints

Containers

• GET /api/containers - List all containers
• POST /api/containers/:id/start - Start container
• POST /api/containers/:id/stop - Stop container
• POST /api/containers/:id/restart - Restart container
• POST /api/containers/:id/pause - Pause container
• POST /api/containers/:id/unpause - Unpause container
• DELETE /api/containers/:id - Remove container

Images

• GET /api/images - List all images
• POST /api/images/:id/run - Run container from image
• DELETE /api/images/:id - Remove image

Volumes

• GET /api/volumes - List all volumes
• POST /api/volumes - Create volume
• DELETE /api/volumes/:name - Remove volume

---

🔧 Configuration

The server can be configured via CLI arguments:

node bin/cli.js --port 3000 --no-open

Option	Description	Default
--port	Server port	3000
--no-open	Don't open browser	false

---

📄 License

MIT License - feel free to use this project for personal or commercial purposes.