Skip to main content
Version: Next

Deploying Backstage to production

Prerequisites

  • You have completed the create-app golden path and have a working Backstage app.
  • Your code is pushed to a source control management system (GitHub, GitLab, etc.).
  • You have a general understanding of how your company builds and deploys software.

What should I get out of this guide?

This guide walks through everything you need to get your Backstage instance running in a production environment. By the end, you will have:

  • A Docker image containing your Backstage app.
  • A production database (PostgreSQL) connected to your deployment.
  • A real authentication provider replacing the default guest login.
  • A running deployment, whether on Kubernetes, ECS, or another platform.
  • Monitoring and observability set up with OpenTelemetry.
  • An understanding of how to scale your deployment as usage grows.

Structure

We start with the Docker image since that is the foundation of any deployment. Then we set up the two critical pre-deploy dependencies: a database and authentication. After that, we walk through deploying to Kubernetes and discuss other deployment options. Finally, we cover operational topics like configuration management, monitoring, and scaling.

Next steps