๐ Enterprise-Grade Kubernetes Multi-Cluster Management Platform
Website โข Quick Start โข Documentation โข Discussions โข Roadmap
KubePolaris is a modern Kubernetes cluster management platform built with React + Go. It provides an intuitive web interface to help DevOps and development teams efficiently manage and monitor multiple Kubernetes clusters.
"Polaris" refers to the North Star, symbolizing stable and reliable guidance for Kubernetes cluster operations.
- ๐ฏ User-Centric - Clean, intuitive interface that lowers the K8s learning curve
- ๐ข Enterprise-Ready - Complete permission control, audit logs, multi-cluster management
- ๐ Ecosystem Integration - Seamless integration with Prometheus, Grafana, AlertManager, ArgoCD
- ๐ Out-of-the-Box - One-click Docker deployment, easy to get started
- ๐ฏ Fully Open Source - Apache 2.0 License, community-driven
|
|
|
|
|
|
๐ธ More Screenshots
| Cluster Overview | Workload Management |
|---|---|
| Pod Management | Web Terminal |
|---|---|
# Environmental requirements Docker 20.10+ and Docker Compose 2.0+
# Clone the repository
git clone https://github.com/clay-wangzhi/KubePolaris.git
# Start services
cd KubePolaris/deploy/scripts/
./install.sh
# Access http://${ip}
# Default credentials: admin / KubePolaris@2026todo# Requirements
# - Go 1.24+
# - Node.js 18+
# - MySQL 8.0+
# Start backend (port 8080)
cd kubepolaris
go run cmd/main.go
# Start frontend (port 5173)
cd ui
npm install && npm run dev
# Access http://localhost:5173๐ For detailed installation guide, see Installation Documentation
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ KubePolaris โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ Frontend (React) โ โ
โ โ React 19 ยท TypeScript ยท Ant Design ยท Monaco ยท xterm.js โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ REST / WebSocket โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ Backend (Go) โ โ
โ โ Gin ยท GORM ยท k8s client-go ยท WebSocket ยท JWT โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ โ โ
โ โโโโโโผโโโโโ โโโโโโผโโโโโ โโโโโโผโโโโโ โ
โ โ MySQL โ โ K8s โ โ Monitor โ โ
โ โ Store โ โ Clustersโ โPrometheusโ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
| Layer | Technology | Version |
|---|---|---|
| Frontend | React, TypeScript, Ant Design, Vite | 19.x, 5.8, 5.x, 7.x |
| Backend | Go, Gin, GORM | 1.24, 1.9, 1.30 |
| Database | MySQL | 8.0+ |
| K8s Client | client-go | 0.29 |
| Monitoring | Prometheus, Grafana | - |
kubepolaris/
โโโ cmd/ # Application entry
โโโ internal/ # Internal packages
โ โโโ handlers/ # HTTP handlers
โ โโโ services/ # Business services
โ โโโ models/ # Data models
โ โโโ middleware/ # Middleware
โ โโโ router/ # Router configuration
โ โโโ k8s/ # K8s client wrapper
โโโ ui/ # Frontend source
โ โโโ src/
โ โ โโโ pages/ # Page components
โ โ โโโ components/ # Common components
โ โ โโโ services/ # API services
โ โ โโโ types/ # Type definitions
โโโ deploy/ # Deployment configs
โ โโโ docker/ # Docker configs
โ โโโ docker-compose/ # Compose files
โ โโโ yaml/ # K8s YAML
โโโ website/ # Documentation site
โโโ configs/ # Configuration files
| Module | Status | Description |
|---|---|---|
| Cluster Management | โ | Import, switch, monitor, delete |
| Node Management | โ | List, details, operations, SSH |
| Workloads | โ | Deploy/STS/DS/Job/CronJob |
| Pod Management | โ | List, logs, terminal, delete |
| Config Management | โ | ConfigMap, Secret |
| Network Management | โ | Service, Ingress |
| Storage Management | โ | PV, PVC, StorageClass |
| User & Permissions | โ | Users, roles, RBAC |
| Monitoring | โ | Prometheus, Grafana |
| Alerting | โ | AlertManager integration |
| GitOps | โ | ArgoCD integration |
| Audit Logs | โ | Operation logs, session audit |
| Global Search | โ | Cross-cluster resource search |
| i18n | ๐ง | Planned for v1.1 |
See ROADMAP.md for the detailed plan.
- v1.1 (Q2 2026) - i18n support, OAuth2/OIDC integration, cost analysis
- v1.2 (Q3 2026) - Multi-tenancy, NetworkPolicy management, Service Mesh visualization
- v2.0 (Q4 2026) - Cluster lifecycle management, backup & restore, plugin system
We welcome all contributions!
- ๐ Report Bug
- ๐ก Request Feature
- ๐ Improve Documentation
- ๐ง Submit PR
# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/kubepolaris.git
# 2. Create feature branch
git checkout -b feature/amazing-feature
# 3. Commit changes
git commit -m 'feat: add amazing feature'
# 4. Push and create PR
git push origin feature/amazing-featureSee CONTRIBUTING.md for detailed guidelines.
| Document | Link |
|---|---|
| ๐ Official Website | kubepolaris.clay-wangzhi.com |
| ๐ User Documentation | docs |
| ๐ Quick Start | quick-start |
| ๐ฆ Installation Guide | installation |
| ๐ง Configuration | configuration |
| ๐ API Reference | api-reference |
- ๐ญ GitHub Discussions - Q&A and feature discussions
- ๐ข Slack - Real-time chat
- ๐ง Mailing List: kubepolaris@googlegroups.com
If you discover a security vulnerability, please see SECURITY.md for the reporting process.
KubePolaris is open-sourced under the Apache License 2.0.
Thanks to these amazing open source projects:
- Kubernetes - Container orchestration platform
- Gin - Go web framework
- Ant Design - React UI component library
- client-go - Kubernetes Go client
- xterm.js - Terminal component
Special thanks to all contributors!
If KubePolaris helps you, please give us a โญ๏ธ Star!