Request access

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

What is Backstage?

André Cavalheiro
André Cavalheiro
Customer Reliability Engineer
André Cavalheiro
September 18, 2023
 min read
What is Backstage?

Why Service Catalogs and Developer Portals Are the Future of DevOps

In the current fast-paced world of tech companies, a seamless developer experience is pivotal. The demand to develop, deploy swiftly, while maintaining product quality, requires robust tools to streamline processes. Yet few are the companies able to showcase a high level of devops maturity. Enter the rise of Platform Engineering, bringing with it internal developer portals which aim to provide cohesion and efficiency with their dynamic and versatile service catalogs. To learn more about this trend and where it’s heading, we recommend Rely’s white paper: The Ultimate Guide to Internal Developer Portals in the Age of Platform Engineering.

The previous era championed the "build fast and break things” approach which led to the proliferation of spreadsheets-based service catalogs leading to chaos, uncoordination, frustration and inefficiency. But with growth came the necessity for refined tooling for this very purpose, especially in big companies like Spotify: hence the birth of Backstage.

Spotify's Backstage

Backstage is a widely used, open-source developer portal platform. It encapsulates and streamlines infrastructure, CI/CD, and operational expertise needed for seamless product operation. Furthermore, it stands as a central point of information for an organization's inventory of services including how to operate and maintain them.

The Challenges Backstage Addresses

Companies can easily get trapped in a maze of fragmented information and manual processes. In these cases, the journey from conceptualizing a new service to developing it, deploying it and ensuring that it meets all the requirements and is working as intended becomes a Herculean task.

Creating a service is not merely about coding; it's an intricate dance involving provisioning infrastructure, setting up CI/CD, ensuring proper logging, monitoring, and alerting systems. Information is scattered across platforms like GitHub, LogDNA, Datadog, or PagerDuty, demanding extensive legwork by developers  – the process is tedious.

The result is often increased knowledge silos, increased complexity, and inefficiency.

How IDPs Transform Developer Experience

The importance of user experience is well understood - if users aren’t happy they won’t continue to use your product - but what about developer experience? Equip engineering teams with tools like IDPs, and watch a cascade of benefits: superior products, minimal outages, swift feature rollouts, shorter engineering ramp-ups and let’s not forget: happier engineers.

Backstage addresses this need by presenting a platform that can tailor to your unique software ecosystem if you allocate the time and resources for that customization - which can be considerable.

Out of the box Backstage features

Backstage includes several features for organizing software and related documentation:

1. Service Catalog:

Core Purpose: Organize and Manage Development Assets

At the heart of Backstage lies the Service Catalog. It acts as a comprehensive directory, listing all of your organization's services, applications, pipelines, and other essential components. Not only does it provide a clear view of service ownership, but it also simplifies the discovery of services within large organizations, fostering improved collaboration.

2. Software Templates:

Core Purpose: Standardized and Rapid Service Creation

One of Backstage's compelling features is its ability to facilitate the creation of bespoke software product templates tailored for your company's unique needs. These templates encapsulate both standards and tooling required for different applications or components. The result? A streamlined process that enables teams to initiate new projects swiftly and within predefined guidelines.

3. Tech Docs:

Core Purpose: Centralized and Updated Technical Documentation

With Tech Docs, Backstage eliminates the often chaotic management of technical documentation. Instead of sifting through disparate repositories or outdated wikis, teams can effortlessly maintain and access their documentation, right from their respective code repositories. This ensures that the documentation is not only current but also aligned with the codebase.

4. Plugins:

Core Purpose: Enhance Functionality and Integration

Backstage's architecture is inherently extensible. Its open platform readily accepts plugins, both developed by the vast open-source community and by internal teams. This provides an avenue to seamlessly integrate a multitude of systems essential for building, deploying, and operating applications. And with the introduction of paid plugins in late 2022, there's now even more flexibility and options at users' fingertips.

The Realities of Implementing Backstage

As great a tool as Backstage is, it's not a plug-and-play solution. It requires a dedicated team equipped with diverse skills. Even post-deployment, infrastructure configuration, integration setups, and end-user support are inevitable responsibilities. This results not only in tangible costs but also in intangible ones, as its maintenance demands attention away from primary business goals, potentially impacting high-impact projects.

Let’s dig a bit deeper into the particular struggles of configuring maintaining Backstage:

1. Customization Overhead:

Each organization's requirements are unique, because of that, Backstage allows for a wide range of customization regarding pretty much all aspects of the tool. Picking the right thing for your organization can require research as well as strong alignment between different stakeholders. The wrong choice can have unforeseen negative ramifications down the line. 

Customization options include but are not limited to the following areas:

  • User Interface: Tailoring UI components and views, updating the menu and sidebar items, and even adjusting the application's theme, branding, and general aesthetics.
  • Workflow Customizations: Teams often need to develop custom code to automate processes and achieve their intended purposes.
  • Security and Governance: Establishing intricate permissions policies, encompassing role-based access control (RBAC), governance frameworks, and more.
  • Plugins and Integrations: Besides the platform's inherent customization capabilities, Backstage has an extensive list of plugins. Each comes with its distinct set of features and considerations that you need to account for.

Basically, while some customization is good, sometimes you want something that “just works” - that’s designed with the best practices in mind and will help you answer the questions that you already have instead of raising new ones. 

2. High Maintenance Costs:

When organizations embrace the Backstage platform, they aren’t simply adding another tool to their stack; they’re committing to a journey. 

On the tangible side, there’s the immediate investment in infrastructure to host and run the platform. But more notably, setting up, configuring, and continuously maintaining Backstage can become a monumental task - so much so that it is not unusual for organizations to assign an entire team solely for this purpose. 

Among the community it’s highlighted that updating Backstage versions can be particularly tricky due to plugin compatibility among other things. Planning an update must be done with the proper amount of planning in place to avoid catastrophic consequences. In the worst case scenarios plugins that have become important to the workflows of your organization may stop being maintained which leaves the company at a crossroad, should they: 1) avoid updating Backstage forever? 2) Drop their dependence on the plugin? Or 3) Pick up the maintenance themselves? 

The intangible costs can be even heavier depending on the context. Time spent on maintaining Backstage is time diverted from core business projects and initiatives. This shift in focus can manifest as opportunity costs. When teams are pulled away from high-impact projects to handle Backstage maintenance, the organization misses out on pivotal advancements, innovations, and market opportunities. 

3. Ensuring the consistency of the software catalog as a source of truth:

One of the core promises of Backstage is to provide a unified view, acting as a singular source of truth for your software landscape. However, ensuring this continuous truthfulness and keeping it in sync with the remaining tools and platforms used by an organization isn't a straightforward task.

Various plugins exist to try to streamline and automate this process, but they aren't flawless. The varying nature of tools, their unique specifications, and frequent updates can lead to inconsistencies and discrepancies between what's represented in Backstage and the real state of affairs in different tools.

This challenge is aggravated by the fact that Backstage is self-hosted - with ownership comes responsibility. When something breaks or an integration goes awry, it falls upon the organization to remedy the situation. Consequently, many enterprises, recognizing the intricacies of their environments and the importance of accurate representations, choose to develop their own plugins. This tailored approach, while potentially addressing specific challenges, brings even more of the same potential problems already mentioned: an overhead in terms of development, maintenance, and updates.


To summarize, and as a Backstage user put in a public forum: “The idea of backstage is super cool, but for me, as a DevOps engineer, the fact that I need to write a lot of React code and continuously fix things made me leave the project.”

How does Backstage Compare to Rely?

Backstage demands a significant initial time and resource investment, but the benefits of internal developer portals have been widely validated at this point. As a cloud-native solution, Rely simplifies tasks and fosters team collaboration. When pitted against Backstage, Rely promises a reduced total cost of ownership, quicker setup, and enhanced usability.

In essence, while Backstage is a formidable addition to the developer portal landscape, it demands meticulous planning, effort, and maintenance. It's essential to weigh its advantages against potential challenges before deciding on its implementation for your team. If you’re looking for alternatives, Rely is probably what you need, book a demo today.

André Cavalheiro
André Cavalheiro
Customer Reliability Engineer
André Cavalheiro
On this page
Previous post
There is no previous post
Back to all posts
Next post
There is no next post
Back to all posts
Our blog
See related articles
Migrate from Backstage to
Migrate from Backstage to
Backstage tries to solve the “big infrastructure problem” with a platform that aims to collect all your resources under a single roof but has some shortcomings that solves effortlessly
John Demian
John Demian
April 2, 2024
Building a business case for an Internal Developer Portal
Building a business case for an Internal Developer Portal
We’re diving into the ‘nitty-gritty’ of putting together the actual business case for your IDP.
Peter Evans
Peter Evans
October 18, 2023
How do I convince my boss I need an Internal Developer Portal?
How do I convince my boss I need an Internal Developer Portal?
How to affect change in your organization by Empowering Engineers with IDPs
Peter Evans
Peter Evans
September 25, 2023