A modern, intuitive Kubernetes dashboard

Documentation
English

Kube Sentinel is a lightweight, modern Kubernetes dashboard that provides an intuitive interface for managing and monitoring your Kubernetes clusters. It offers real-time metrics, comprehensive resource management, multi-cluster support, and a beautiful user experience.

Comprehensive cluster overview with real-time metrics and resource statistics

• 🌓 Multi-Theme Support - Dark/light/color themes with system preference detection
• 🔍 Advanced Search - Global search across all resources
• 🌐 Internationalization - Support for English language
• 📱 Responsive Design - Optimized for desktop, tablet, and mobile devices

• 🔄 Seamless Cluster Switching - Switch between multiple Kubernetes clusters
• 📊 Per-Cluster Monitoring - Independent Prometheus configuration for each cluster
• ⚙️ Kubeconfig Integration - Automatic discovery of clusters from your kubeconfig file
• 🔐 Cluster Access Control - Fine-grained permissions for cluster access management

• 📋 Full Resource Coverage - Pods, Deployments, Services, ConfigMaps, Secrets, PVs, PVCs, Nodes, and more
• 📄 Live YAML Editing - Built-in Monaco editor with syntax highlighting and validation
• 📊 Detailed Resource Views - In-depth information with containers, volumes, events, and conditions
• 🔗 Resource Relationships - Visualize connections between related resources (e.g., Deployment → Pods)
• ⚙️ Resource Operations - Create, update, delete, scale, and restart resources directly from the UI
• 🔄 Custom Resources - Full support for CRDs (Custom Resource Definitions)
• 🏷️ Quick Image Tag Selector - Easily select and change container image tags based on Docker and container registry APIs
• 🎨 Customizable Sidebar - Customize sidebar visibility and order, and add CRDs for quick access
• 🔌 Kube Proxy - Access pods or services directly through Kube Sentinel, no more kubectl port-forward

• 📊 Real-time Metrics - CPU, memory, and network usage charts powered by Prometheus
• 📋 Cluster Overview - Comprehensive cluster health and resource statistics
• 📝 Live Logs - Stream pod logs in real-time with filtering and search capabilities
• 💻 Web/Node Terminal - Execute commands directly in pods/nodes through the browser
• 📈 Node Monitoring - Detailed node-level performance metrics and utilization
• 📊 Pod Monitoring - Individual pod resource usage and performance tracking

• 🛡️ OAuth Integration - Supports OAuth management in the UI
• 🔒 Role-Based Access Control - Supports user permission management in the UI
• 👥 User Management - Comprehensive user management and role allocation in the UI
• 🔍 Security Scanning - Integration with Trivy Operator for vulnerability, config audit, and secret scanning
• 📊 Security Dashboard - Cluster-wide security posture overview with severity breakdowns

For detailed instructions, please refer to the documentation.

To run Kube Sentinel using Docker, you can use the pre-built image:

docker run --rm -p 8080:8080 ghcr.io/pixelvide/kube-sentinel:1.2.0

1. Add Helm repository

   helm repo add kube-sentinel https://pixelvide.github.io/kube-sentinel
   helm repo update

2. Install with default values

   helm install kube-sentinel kube-sentinel/kube-sentinel -n kube-system

1. Apply deployment manifests

   kubectl apply -f deploy/install.yaml
   # or install it online
   kubectl apply -f https://raw.githubusercontent.com/pixelvide/kube-sentinel/refs/tags/v1.2.0/deploy/install.yaml

2. Access via port-forward

   kubectl port-forward -n kube-system svc/kube-sentinel 8080:8080

1. Clone the repository

   git clone https://github.com/pixelvide/kube-sentinel.git
   cd kube-sentinel

2. Build the project

   make deps
   make build

3. Run the server

   make run

For troubleshooting, please refer to the documentation.

We welcome contributions! Please see our contributing guidelines for details on how to get involved.

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.