Skip to content
This is an unmaintained snapshot of the Astro v5 docs. View the latest docs.

Deploy your Astro Site to Surge

You can deploy your Astro project to Surge, a single-command web publishing platform designed for front-end developers.

How to deploy

Section titled “How to deploy”

  1. Install the Surge CLI globally from the terminal, if you haven’t already.

    Terminal window
    npm install -g surge

  2. Build your Astro site from your project’s root directory.

    Terminal window
    npm run build

  3. Deploy to Surge using the CLI.

    Terminal window
    surge dist

    You can use a custom domain with Surge when deploying by running surge dist yourdomain.com.

More Deployment Guides

Contribute Community Sponsor