Skip to main content

DevsPortal documentation

DevsPortal is a self-service internal developer platform (IDP) on Kubernetes. It gives platform teams a production-ready foundation — a Backstage-powered developer portal, golden-path abstractions, CI/CD, GitOps, and observability — that they can brand, run, and own.

DevsPortal is white-label: every customer gets their own brand on the same engine. Fedshi is customer #1, and this documentation uses the live Fedshi instance (https://console.idp.fedshi.com) as its worked example throughout.

note

DevsPortal is built on the Control Plane Operator engine. You'll see openchoreo.* names in Kubernetes resources, the API, and the CLI — those are the engine's internals and are intentionally unchanged. The product you present, deploy, and sell is DevsPortal.

Find your path​

👤 I'm new and want to understand it​

Start with the Overview — what DevsPortal is, why it exists, and how the architecture works. Then skim the Concepts.

DevsPortal serves two personas — pick yours:

🧩 Platform Engineer — I set up tenancy & author golden paths​

Go to the Platform Engineer guide: create organizations, projects, users, and teams, and author the ComponentTypes, Traits, ResourceTypes, Workflows, and Environments that developers build on top of.

💻 Developer — I build & ship apps on the IDP​

Go to the Developer guide: get access, deploy your first component in minutes, then projects, builds, deployments, dependencies, and observability.

Quick reference​