Deploy your Astro Site to Vercel

You can use Vercel to deploy an Astro site to their global edge network with zero configuration.

This guide includes instructions for deploying to Vercel through the website UI or Vercel’s CLI.

Your Astro project can be deployed to Vercel as a static site, or as a server-side rendered site (SSR).

Your Astro project is a static site by default. You don’t need any extra configuration to deploy a static Astro site to Vercel.

To enable SSR in your Astro project and deploy on Vercel:

  1. Install the Vercel adapter to your project’s dependencies.

    npm install --save-dev @astrojs/vercel
  2. Add two new lines to your astro.config.mjs project configuration file.

    astro.config.mjs
    import { defineConfig } from 'astro/config';
    + import vercel from '@astrojs/vercel/serverless';
    
    export default defineConfig({
    +   output: 'server',
    +   adapter: vercel(),
    });

You can deploy to Vercel through the website UI or using Vercel’s CLI (command line interface). The process is the same for both static and SSR Astro sites.

  1. Push your code to your online Git repository (GitHub, GitLab, BitBucket).
  2. Import your project into Vercel.
  3. Vercel will automatically detect Astro and configure the right settings.
  4. Your application is deployed! (e.g. astro.vercel.app)

After your project has been imported and deployed, all subsequent pushes to branches will generate Preview Deployments, and all changes made to the Production Branch (commonly “main”) will result in a Production Deployment.

📚 Learn more about Vercel’s Git Integration.

  1. Install the Vercel CLI and run vercel to deploy.

    npm i -g vercel
    vercel
  2. Vercel will automatically detect Astro and configure the right settings.

  3. When asked Want to override the settings? [y/N], choose N.

  4. Your application is deployed! (e.g. astro.vercel.app)

More Deployment Guides

Filter by deploy type