README
¶
OpenChoreo
Internal Developer Platform
What is OpenChoreo?
OpenChoreo is an open-source internal developer platform (IDP) designed for both platform engineers and developers.
- For platform engineers, Choreo offers a customizable yet fully-featured platform that integrates CI/CD, security, and cloud tools, enforcing best practices while reducing operational overhead.
- For developers, it abstracts away infrastructure complexities, enabling them to focus on building and deploying applications with minimal friction.
Most organizations face a dilemma when adopting an IDP:
- Build their own by integrating multiple tools—offering control but requiring significant engineering effort and maintenance.
- Buy a SaaS-based IDP, which simplifies adoption but often limits customization and flexibility.
OpenChoreo provides a third path—a self-hosted, open-source IDP that delivers production-grade capabilities out of the box without sacrificing control or flexibility.
Inspired by WSO2 Choreo SaaS
OpenChoreo is inspired by WSO2 Choreo SaaS, an enterprise-grade internal developer platform that has been adopted by organizations to streamline software delivery and engineering.
WSO2 Choreo SaaS provides a complete IDP experience, combining:
- Software Delivery – Seamless workflows to build, deploy, run, and manage applications at scale.
- Software Engineering – Advanced capabilities for API management, modularity, service reuse, and observability.
With OpenChoreo, we are bringing these capabilities to the open-source community—allowing organizations to run, extend, and customize an internal developer platform on their own infrastructure, while WSO2 Choreo SaaS remains a fully managed alternative.
Getting Started
The easiest way to try OpenChoreo is by following the Quick Start Guide. It walks you through setting up Choreo using a Dev Container, so you can start experimenting without affecting your local environment.
For a deeper understanding of OpenChoreo’s architecture, see Choreo Concepts.
Visit Installation Guide to learn more about installation methods.
Samples
Explore hands-on examples to help you configure and deploy applications using OpenChoreo.
- Configuring Choreo – Set up organizations, environments, data planes, and deployment pipelines.
- Deploying Applications – Deploy services, web apps, and scheduled tasks.
Check out the Samples Directory for more details.
Join the Community & Contribute
We’d love for you to be part of OpenChoreo’s journey! Whether you’re fixing a bug, improving documentation, or suggesting new features, every contribution counts.
- Contributor Guide – Learn how to get started.
- Report an Issue – Help us improve Choreo.
- Join our Discord – Be part of the community.
We’re excited to have you onboard!
Roadmap
Explore the OpenChoreo roadmap, including completed milestones and upcoming plans, in our Roadmap.
License
OpenChoreo is licensed under Apache 2.0. See the LICENSE file for full details.
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
v1
Package v1 contains API Schema definitions for the core v1 API group.
|
Package v1 contains API Schema definitions for the core v1 API group. |
|
choreoctl
command
|
|
|
internal
|
|
|
choreoctl/cmd/delete
Package delete provides functionality to delete Choreo resources
|
Package delete provides functionality to delete Choreo resources |
|
dataplane/kubernetes/types
Package types contains resource type definitions for the Kubernetes integration that are derived from the following projects: - Cilium: https://github.com/cilium/cilium/tree/main/pkg/k8s/apis/cilium.io - Argo Workflow: https://github.com/argoproj/argo-workflows/tree/main/pkg/apis/workflow - Secret Store CSI Driver: https://github.com/kubernetes-sigs/secrets-store-csi-driver/tree/main/apis/v1
|
Package types contains resource type definitions for the Kubernetes integration that are derived from the following projects: - Cilium: https://github.com/cilium/cilium/tree/main/pkg/k8s/apis/cilium.io - Argo Workflow: https://github.com/argoproj/argo-workflows/tree/main/pkg/apis/workflow - Secret Store CSI Driver: https://github.com/kubernetes-sigs/secrets-store-csi-driver/tree/main/apis/v1 |
|
dataplane/kubernetes/types/argoproj.io/workflow/v1alpha1
Package v1alpha1 is the v1alpha1 version of the API.
|
Package v1alpha1 is the v1alpha1 version of the API. |
|
pkg
|
|
|
test
|
|