Welcome to KubeStellar Documentation
KubeStellar simplifies multi-cluster Kubernetes management, enabling you to deploy and manage workloads across multiple clusters with ease.
📖 Looking for Legacy Docs?
This unified site currently only includes docs for the version of KubeStellar tagged Latest. For other versions you may visit the Legacy Docs Site hosted via GitHub Pages and mkdocs.
Choose Your Installation Path
Select the installation path that best fits your needs:
🚀 Local Development
For testing, learning, and development
- ✓ Free to use
- ✓ Quick setup (10-15 minutes)
- ✓ Requirements: Docker, Kind
- ✓ Kubernetes 1.34+
☁️ AWS EKS Cloud
For production and enterprise deployments
- ✓ Production-ready on EKS 1.34
- ✓ Setup time (20-30 minutes)
- ✓ Requirements: AWS Account, eksctl, kubectl, Helm, kflex, clusteradm
- ✓ High scalability & availability
Quick Comparison
| Feature | Local Development | AWS EKS Cloud |
|---|---|---|
| Use Case | Testing, Learning | Production, Enterprise |
| Prerequisites | Docker, Kind | AWS Account (EC2, EKS, IAM, VPC, CloudFormation), eksctl, kubectl, Helm, kflex, clusteradm |
| Setup Time | 10-15 minutes | 20-30 minutes |
| Cost | Free | AWS charges apply (~$300-400/month) |
| Scalability | Limited (local) | High (cloud-native) |
| Kubernetes Version | 1.34+ | EKS 1.34 |
| Region | N/A | us-east-1 recommended |
| Minimum Quotas | N/A | vCPU: 12, Elastic IPs: 4, Target Groups: 5, NLBs: 2 |
Quick Navigation
New to KubeStellar?
Start here to understand what KubeStellar is and how it works:
- Overview - Learn about KubeStellar’s architecture and core concepts
- Architecture - Understand the system design
- Quick Installation - Get up and running in minutes (Local)
- AWS EKS Install - Production guide for EKS (Cloud)
Install & Configure
Ready to set up KubeStellar? Follow our installation guides:
- Setup Overview - Installation overview
- Prerequisites - Check system requirements
- Core Helm Chart - Install KubeStellar core components
- KubeFlex Hosting Cluster - Set up your hosting environment
- Register Workload Clusters - Connect your execution clusters
- AWS EKS Install - Install KubeStellar on AWS
- GCP Deployment Guide - KubeStellar GCP Deployment Guide
Use & Integrate
Learn how to leverage KubeStellar’s features:
- KubeStellar API - Control workload distribution and status
- Example Scenarios - Follow practical examples
- Third-party Integrations - Connect with ArgoCD and other tools
User Guide & Support
Get help and find solutions:
- User Guide - Complete usage documentation
- Troubleshooting - Resolve common issues
- Known Issues - Current limitations and workarounds
UI & Tools
Explore KubeStellar’s ecosystem:
- UI Overview - Web interface and visualization
- KubeStellar Galaxy - Discover community resources
- KubeFlex - Flexible Kubernetes management
Get Started Now
Choose your path:
- Quick Demo - Run our automated setup script to create a demo environment in minutes
- Step-by-Step - Follow the detailed installation guide to understand each component
- Production - Review the full deployment guide for production-ready configurations
Need help? Check our troubleshooting guide or explore the known issues.