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 supportDirect link to Runtime support
Mastra can run against any of these runtime environments:
- Node.js
v22.13.0or later - Bun
- Deno
- Cloudflare
Deployment OptionsDirect link to Deployment Options
Mastra ServerDirect 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.
MonorepoDirect 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 ProvidersDirect 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 FrameworkDirect 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 CloudDirect 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 RunnersDirect 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.