Skip to content
Grada

Migrating Astro from Vercel to AWS Fargate

If you are seeing a warning from grada about your Astro adapter, it means your project is currently configured to build specifically for Vercel’s proprietary serverless network.

To deploy Astro as a containerized application on standard AWS infrastructure, you simply need to switch to Astro’s official Node.js adapter.

How to Fix

Section titled “How to Fix”

1. Install the Node adapter

Section titled “1. Install the Node adapter”

Run the following command in your terminal to swap out the Vercel adapter for the Node adapter:

Terminal window
npm install @astrojs/node
npm uninstall @astrojs/vercel

2. Update astro.config.mjs

Section titled “2. Update astro.config.mjs”

Open your Astro configuration file and replace the Vercel import with the Node import.

Before (Vercel Lock-in):

import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';


export default defineConfig({
  output: 'server',
  adapter: vercel(),
});

After (AWS Ready):

import { defineConfig } from 'astro/config';
import node from '@astrojs/node';


export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'standalone'
  }),
});

3. Deploy

Section titled “3. Deploy”

That’s it! Your Astro app is now decoupled from Vercel.

Run npx grada-run apply and the CLI will automatically package this standalone Node server into a hardened Docker container and deploy it to your AWS cluster.

Next steps

Section titled “Next steps”