Deploy your Astro Site to Heroku

import { Steps } from '@astrojs/starlight/components';

Heroku is a platform-as-a-service for building, running, and managing modern apps in the cloud. You can deploy an Astro site to Heroku using this guide.

:::caution The following instructions use the deprecated heroku-static-buildpack. Please see Heroku's documentation for using heroku-buildpack-nginx instead. :::

How to deploy

<Steps> 1. Install the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli).

2. Create a Heroku account by signing up.

3. Run heroku login and fill in your Heroku credentials:

   bashCopy

   $ heroku login
   

4. Create a file called static.json in the root of your project with the below content:

   jsonCopy

   {
     "root": "./dist"
   }
   

   This is the configuration of your site; read more at heroku-buildpack-static.

5. Set up your Heroku git remote:

   bashCopy

   # version change
   $ git init
   $ git add .
   $ git commit -m "My site ready for deployment."
   
   # creates a new app with a specified name
   $ heroku apps:create example
   
   # set buildpack for static sites
   $ heroku buildpacks:set https://github.com/heroku/heroku-buildpack-static.git
   

6. Deploy your site:

   bashCopy

   # publish site
   $ git push heroku master
   
   # opens a browser to view the Dashboard version of Heroku CI
   $ heroku open
   

</Steps>