backstage/docs/deployment/heroku.md

id, title, sidebar_label, description

id	title	sidebar_label	description
heroku	Deploying with Heroku	Heroku	How to deploy Backstage to Heroku

Heroku is a Platform as a Service (PaaS) designed to handle application deployment in a hands-off way. Heroku supports container deployment of Docker images, a natural fit for Backstage.

Configuring the CLI

First, install the heroku-cli and login:

$ heroku login

Heroku runs a container registry on registry.heroku.com. To push Backstage Docker images, log in to the container registry also:

$ heroku container:login

You might also need to set your Heroku app's stack to container:

$ heroku stack:set container -a <your-app>

Push and deploy a Docker image

Now we can push a Backstage Docker image to Heroku's container registry and release it to the web worker:

$ heroku container:push web -a <your-app>
$ heroku container:release web -a <your-app>

Now you should have Backstage up and running! 🎉