Welcome to KubeStellar

KubeStellar is a Kubernetes-native multi-cluster orchestration platform that enables organizations to deploy and manage applications consistently across multiple Kubernetes clusters, cloud providers, and edge environments through a unified control plane.

Designed for scalability and flexibility, KubeStellar simplifies multi-cluster application delivery while preserving the familiar Kubernetes experience.


Why KubeStellar?

Managing applications across multiple Kubernetes clusters introduces challenges such as workload placement, configuration management, and operational consistency. KubeStellar addresses these challenges with a declarative, Kubernetes-native approach that enables centralized management without sacrificing cluster independence.

With KubeStellar, you can:

  • Deploy applications across multiple Kubernetes clusters from a single control plane.
  • Define placement policies that automatically determine where workloads should run.
  • Customize deployments for individual clusters without maintaining multiple copies of manifests.
  • Operate consistently across cloud, on-premises, hybrid, and edge environments.
  • Continue using familiar Kubernetes APIs, tooling, and workflows.

Key Capabilities

CapabilityDescription
Multi-Cluster DeploymentDeploy and manage workloads across multiple Kubernetes clusters from a unified control plane.
Policy-Based PlacementAutomatically schedule workloads using flexible placement policies and cluster selection rules.
Cluster CustomizationApply cluster-specific configuration while maintaining a single source of application manifests.
Edge and Hybrid Cloud SupportManage applications consistently across cloud, on-premises, and edge infrastructure.
Kubernetes-Native ArchitectureBuilt entirely on standard Kubernetes APIs and declarative resource definitions.
Scalable OperationsSimplify large-scale application management across distributed Kubernetes environments.

Architecture Overview

KubeStellar separates application management from workload execution, allowing platform teams to define application deployment policies centrally while individual clusters remain independently managed.

A typical KubeStellar deployment includes:

  • A centralized management plane
  • or more workload clusters
  • Policy-based workload placement
  • Automated synchronization between management and workload clusters

This architecture enables scalable, secure, and consistent application delivery across distributed Kubernetes environments.


Get Started

Choose the documentation that best matches your use case.

DocumentationDescription
KubeStellar CoreLearn how to install, configure, and operate the KubeStellar platform.
Quick Start GuideDeploy your first multi-cluster application in just a few steps.
ArchitectureUnderstand the architecture, core concepts, and design principles behind KubeStellar.
User GuideExplore features, configuration options, and operational workflows.
Reference DocumentationDetailed API, configuration, and command reference.

Components

KubeStellar consists of several projects that work together to provide a complete multi-cluster management solution.

ComponentPurpose
KubeStellar CorePrimary multi-cluster orchestration platform.
kubectl-multi PluginExtend kubectl with multi-cluster management capabilities.
KubeFlexFlexible Kubernetes control plane management.
ConsoleWeb-based interface for managing KubeStellar environments.
A2A (Application-to-Application)Application-level multi-cluster communication and management.

Documentation

Explore the documentation to learn more about KubeStellar.

  • Installation Guide
  • Quick Start
  • Architecture
  • User Guide
  • API Reference
  • Contributing Guide
  • Community
  • Release Notes

Community

KubeStellar is an open-source project, and contributions from the community are welcome.

Whether you’re reporting bugs, improving documentation, proposing new features, or contributing code, your participation helps improve the project.

  • GitHub Repository
  • GitHub Issues
  • Slack Community
  • Mailing List

Next Steps

If you are new to KubeStellar, we recommend the following learning path:

  1. Install KubeStellar using the Installation Guide.
  2. Complete the Quick Start tutorial.
  3. Learn the core concepts in the Architecture documentation.
  4. Explore advanced deployment scenarios in the User Guide.
  5. Join the community and contribute to the project.

Need Help?

If you encounter issues or have questions:

  • Search existing GitHub Issues.
  • Join the KubeStellar Slack community.
  • Ask questions on the mailing list.
  • Reach out through the community channels.

We are always happy to help new users get started with KubeStellar.