1. Prerequisites
    2. Installing Backstage
    3. Backstage app structure
    4. Running the app
    1. Configuring Backstage
    2. Setting up PostgreSQL
    3. Configuring PostgreSQL
    4. Setting the application name
    5. Setting up authentication
    1. Adding integrations
    2. Adding Components
    3. Configuring for production
    1. Knowledge check

Standing Up Backstage


In this course, you will be installing your very own installation of Backstage. This will be a standalone version of the application, and you will be able to use:

  • Your own instance of Backstage
  • Authentication using GitHub
  • An integration with your source control system
  • A persistent database

This tutorial assumes a basic understanding of working on a Linux based operating system, using tools like apt-get, npm, yarn, curl. Docker knowledge is also helpful for making the best use of your Backstage installation.


There are a few development tools you’ll need to have installed on your computer to get started with Backstage. This guide assumes a basic understanding of command-line tooling and access to a Linux-like terminal environment (e.g. MacOS Terminal or Windows Subsystem for Linux).

  • Access to a Linux-based operating system, such as Linux, MacOS or Windows Subsystem for Linux (WSL)
  • An account with elevated rights to install the dependencies
  • Node Version 16
  • Yarn for dependency management
  • Docker used for features such as Software Templates and Tech Docs
  • Git for source control
Installing on a remote machine, VM, or using a firewall?
If the system is not directly accessible over your network the following ports
need to be opened: 3000, 7007.