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.

Prerequisites

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
  • We recommend using nvm for this
    • Installing nvm
    • Install and change Node version with nvm
• 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.