Deploy with a Web Framework

When Mastra is integrated with a web framework, it deploys alongside your application using the framework's standard deployment process. Follow the instructions below to ensure your Mastra integration deploys correctly.

warning

If you're deploying to a cloud provider, remove any usage of LibSQLStore from your Mastra configuration. LibSQLStore requires filesystem access and is not compatible with serverless platforms.

Integration guides:

• With Next.js
• With Astro

With Next.js on Vercel

If you've integrated Mastra with Next.js by following our guide and plan to deploy to Vercel, add serverExternalPackages: ["@mastra/*"] to your next.config.ts:

next.config.ts

import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  serverExternalPackages: ["@mastra/*"],
};

export default nextConfig;

With Astro on Vercel

If you've integrated Mastra with Astro by following our guide and plan to deploy to Vercel, add the Vercel adapter and server output to your astro.config.mjs:

astro.config.mjs

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

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

With Astro on Netlify

If you've integrated Mastra with Astro by following our guide and plan to deploy to Netlify, add the Netlify adapter and server output to your astro.config.mjs:

astro.config.mjs

import { defineConfig } from "astro/config";
import netlify from "@astrojs/netlify";

export default defineConfig({
  adapter: netlify(),
  output: "server",
});