Ready to build and deploy your Astro site? Follow one of our guides to different deployment services or scroll down for general guidance about deploying an Astro site.
Deployment Guides
Section titled “Deployment Guides”Quick Deploy Options
Section titled “Quick Deploy Options”You can build and deploy an Astro site to a number of hosts quickly using either their website’s dashboard UI or a CLI.
Website UI
Section titled “Website UI”A quick way to deploy your website is to connect your Astro project’s online Git repository (e.g. GitHub, GitLab, Bitbucket) to a host provider and take advantage of continuous deployment using Git.
These host platforms automatically detect pushes to your Astro project’s source repository, build your site and deploy it to the web at a custom URL or your personal domain. Often, setting up a deployment on these platforms will follow steps something like the following:
The host will be automatically configured to watch your Git provider’s main branch for changes, and to rebuild and republish your site at each new commit. These settings can typically be configured in your host provider’s dashboard UI.
CLI Deployment
Section titled “CLI Deployment”Some hosts will have their own command line interface (CLI) you can install globally to your machine using npm. Often, using a CLI to deploy looks something like the following:
Building Your Site Locally
Section titled “Building Your Site Locally”Many hosts like Netlify and Vercel will build your site for you and then publish that build output to the web. But, some sites will require you to build locally and then run a deploy command or upload your build output.
You may also wish to build locally to preview your site, or to catch any potential errors and warnings in your own environment.
Run the command npm run build to build your Astro site.
By default, the build output will be placed at dist/. This location can be changed using the outDir configuration option.