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

40 MINS

Running the Backstage app

The Backstage app is created, the database is set up — now we’re ready to rock and roll 🎸!

Backstage apps running locally have two processes — the backend and the frontend. To start these at the same time, run this command in a terminal window:

cd your-backstage-app
yarn dev

The Backstage app will start both the backend and frontend app.

Screenshot with a lot of logging, ending with the message saying Webpack completed successfully

The Backstage app is ready once you see this line in the terminal:

[0] Webpack compiled successfully

Go to http://localhost:3000/ in a browser and you should see the Backstage software catalog with some sample software components.

When you see the Backstage Software Catalog appear, you've just launched your very first Backstage app. Yay! Just browse a bit and enjoy your hard work. But not too long, there's more things to do!

A closer look at the backend and frontend processes
Backstage apps running locally have two processes — the backend Express server, and a webpack-development-server to run the React frontend.  These processes can also be started separately if you wish, by running the respective commands in different terminal windows:
yarn start-backend
yarn start