⚠️ WORK IN PROGRESS - VERSION 2 CONCEPT
This site contains experimental work for a version 2 concept of idpbuilder. This is not the official current version.
For the official current version, please visit: https://cnoe.io/docs/idpbuilder

Internal Development Platform Binary Launcher

Spin up a complete internal developer platform using industry standard technologies like Kubernetes, Argo, and Backstage with only Docker required as a dependency.

Get Started View on GitHub

About

IDP Builder is a tool that helps you create a complete internal developer platform quickly and easily. It uses industry-standard technologies and can be run with minimal dependencies.

🚀 Quick Setup

Get started with a single binary - Docker is the only dependency required

🏗️ Reference Implementation

Create a single binary demonstrating an IDP reference implementation

🧪 CI Integration

Use within CI pipelines to perform integration testing

💻 Local Development

Perfect as a local development environment for platform engineers

Key Features

  • Built with industry-standard technologies (Kubernetes, Argo, Backstage)
  • Minimal dependencies - only Docker required
  • Easy installation via Homebrew or binary download
  • Cross-platform support (Linux, macOS, Windows)
  • Active community and regular updates

Version 2 Architecture

Version 2 introduces a modern controller-based architecture with clear separation between CLI and controllers:

🔧 CLI for Development

Use idpbuilder create to quickly provision local Kind clusters, deploy controllers, and create platform resources

☸️ Controllers for Production

Deploy idpbuilder controllers via Helm or kubectl to any Kubernetes cluster for production use

🔄 GitOps Native

Manage platform components declaratively through Custom Resources - no CLI required in production

🔌 Pluggable Providers

Choose your Git provider (Gitea, GitHub, GitLab), Gateway (Nginx, Envoy, Istio), and GitOps tool (ArgoCD, Flux)

Two Deployment Modes

Development Mode (CLI-Driven)

  • CLI provisions Kind cluster
  • CLI deploys controllers
  • CLI creates Platform CRs
  • Quick local development

Production Mode (GitOps-Driven)

  • Pre-provisioned K8s cluster
  • Install controllers via Helm
  • CRs managed via GitOps
  • Fully declarative

Getting Started

Installation

Using Homebrew

brew install cnoe-io/tap/idpbuilder

From Releases

arch=$(if [[ "$(uname -m)" == "x86_64" ]]; then echo "amd64"; else uname -m; fi)
os=$(uname -s | tr '[:upper:]' '[:lower:]')

idpbuilder_latest_tag=$(curl --silent "https://api.github.com/repos/cnoe-io/idpbuilder/releases/latest" | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
curl -LO https://github.com/cnoe-io/idpbuilder/releases/download/$idpbuilder_latest_tag/idpbuilder-$os-$arch.tar.gz
tar xvzf idpbuilder-$os-$arch.tar.gz

Usage

Run idpbuilder to spin up your CNOE IDP:

./idpbuilder create

For more detailed information, check out our documentation or visit cnoe.io.

Community

Join our community to get help, share ideas, and contribute: