Deployment

Ready to build and deploy your Astro site? Follow one of our guides to different deployment services or read below for general guidance about deploying an Astro site.

Deployment Guides

• Netlify SSR/Static
• Vercel SSR/Static
• Deno Deploy SSR/Static
• GitHub Pages Static
• GitLab Pages Static
• Cloudflare Pages SSR/Static
• AWS Static
• AWS via SST SSR/Static
• Google Cloud SSR/Static
• Heroku Static
• Fly.io SSR/Static
• Render Static

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 and npm run preview to see the build.

Adding an Adapter for On-demand Rendering

Note

Before deploying your Astro site with on-demand rendering enabled, make sure you have:

• Installed the appropriate adapter to your project dependencies (either manually, or using the adapter’s astro add command, e.g. npx astro add netlify).
• Added the adapter to your astro.config.mjs file’s import and default export when installing manually. (The astro add command will take care of this step for you!)