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 platform for Studio and server deployment.
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.
Mastra platformDirect link to Mastra platform
The Mastra platform provides two products for deploying and managing AI applications built with the Mastra framework:
- Studio: A hosted visual environment for testing agents, running workflows, and inspecting traces
- Server: A production deployment target that runs your Mastra application as an API server
Learn more in the Studio deployment guide and Server deployment guide.
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.
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.