The archive · Work & Ways of Doing · Technical decision · 2016–2025
Spotify's Backstage: an internal developer portal that became the industry standard
Engineers juggling many cloud tools got one internal portal; Spotify open-sourced it and 3,000+ companies built developer platforms on it.
Spotify
What it had to solve
By the mid-2010s Spotify's autonomous-squad culture had produced a sprawling infrastructure: hundreds of microservices running on a stack of Terraform, cloud CLIs, GitLab CI, Prometheus, Kubernetes and Docker, each with its own interface, credentials and rules. Every engineer was expected to master them all, and the cost showed up as context switching, fragmentation and cognitive load.
How it works
By the mid-2010s Spotify ran hundreds of microservices across an engineering culture built on autonomous squads. Every piece of that infrastructure had its own tool — Terraform, cloud CLIs, GitLab CI, Prometheus, Kubernetes, Docker and more — each with different interfaces, credentials and rules. Engineers were expected to know all of them, and the cost showed up as context switching, fragmentation and cognitive load.
Around 2016 Spotify's engineers started solving that with Backstage, an internal developer portal: a software catalog recording what services existed and who owned them, clickable templates that scaffolded a new microservice with best practices already in place, views that followed a pull request from review to production, and documentation written as Markdown in code and rendered in one place. By 2020 the internal installation had more than 100 plugins — one consistent front door for the whole stack.
In March 2020 Spotify open-sourced Backstage on purpose, releasing it early so other companies facing the same fragmentation could shape it — and so it could become the standard rather than a proprietary island Spotify would one day be forced to migrate away from. The Cloud Native Computing Foundation accepted it into its Sandbox that September; by 2025 more than 3,000 organizations had adopted it, all 700 of Spotify's R&D squads still depended on it, and Spotify was selling Spotify Portal for Backstage as an enterprise product.
Why it lands
- The insight was to fix the interface layer, not the tools: instead of replacing Terraform or Kubernetes, Backstage gave every tool one consistent front door.
- A service catalog with explicit ownership turned tribal knowledge into a database, so any engineer could find what existed and who to ask.
- Releasing early made the tool a shared standard instead of a private investment — within months a large share of contributions came from outside Spotify.
- Because Spotify stayed its own most demanding customer, every improvement for the community first had to work for its own hundreds of squads.
What it did
The open-source bet paid off: the Cloud Native Computing Foundation accepted Backstage into its Sandbox in September 2020, and by 2025 more than 3,000 organizations had adopted it to build their own internal developer portals while all 700 of Spotify's R&D squads still ran on it. Spotify turned the framework into a commercial product, Spotify Portal for Backstage.
What you can take
Release your best internal tool as a public platform: open-sourcing Backstage kept Spotify from ever being forced to migrate off its own invention, and the industry did the rest.
Since then
Backstage helped create a category — the internal developer platform (IDP) — and became one of the Cloud Native Computing Foundation's most visible projects. Spotify built an enterprise business on it, launching Spotify Portal for Backstage in beta in 2024 and extending the open-source framework with a no-code plugin manager, while the framework itself grew to more than 3,000 adopting organizations by 2025, from airlines to investment firms. Inside Spotify it remained the daily tool of all 700 R&D squads, the demanding first customer every improvement had to satisfy.
Sources
- What the Heck is Backstage Anyway?
- Backstage: Spotify Developer Portals with Stefan Ålund
- Celebrating Five Years of Backstage: From Open Source Project to Enterprise Business
spotted an error? The archive wants to know.
Your turn
You just read one. Describe the brief you are staring at, and see who has been given the same problem.
Free account · 3 free questions · no card