Skip to main content
Mastra 1.0 is available 🎉 Read announcement

Deployment Overview

Mastra applications can be deployed to any Node.js-compatible environment. You can deploy a Mastra server, integrate with an existing web framework, deploy to cloud providers, or use Mastra Cloud for managed hosting.

Runtime support
Direct link to Runtime support

Mastra can run against any of these runtime environments:

  • Node.js v22.13.0 or later
  • Bun
  • Deno
  • Cloudflare

Deployment Options
Direct link to Deployment Options

Mastra Server
Direct link to Mastra Server

Mastra provides a server powered by Hono that can be deployed independently. Use the mastra build command to build your application and deploy the output to your preferred VM, container, or PaaS platform.

Use this option when you need full control over your infrastructure, long-running processes, or WebSocket connections. The Mastra server deployment guide provides more details.

Monorepo
Direct link to Monorepo

Deploy a Mastra server as part of a monorepo setup, following the same approach as standalone deployment.

Read about monorepo deployment.

Cloud Providers
Direct link to Cloud Providers

Mastra applications can be deployed to cloud providers and serverless platforms. Mastra includes optional built-in deployers for Vercel, Netlify, and Cloudflare to automate the build and deployment process.

Use this option for auto-scaling, minimal infrastructure management, or when you're already using one of these platforms.

Web Framework
Direct link to Web Framework

When Mastra is integrated with a web framework, it deploys alongside your application using the framework's standard deployment process. The guides below cover framework-specific configuration requirements for deployment.

Use these guides when adding Mastra to an existing Next.js or Astro application.

Mastra Cloud
Direct link to Mastra Cloud

We're building Mastra Cloud to be the easiest place to deploy and observe your Mastra agents. It's currently in beta.

Learn more in the Mastra Cloud docs.

Workflow Runners
Direct link to Workflow Runners

Mastra workflows run using the built-in execution engine by default. For production workloads requiring managed infrastructure, workflows can also be deployed to specialized platforms like Inngest that provide step memoization, automatic retries, and real-time monitoring.

Visit the Workflow Runners guide for execution options and the Inngest deployment guide for setup instructions.