build Command - Medusa CLI Reference

Create a standalone build of the Medusa application that you can deploy to production.

This creates a build that:

  • Doesn't rely on the source TypeScript files.
  • Can be copied to a production server reliably.

The build is output to a new .medusa/server directory.

Terminal
npx medusa build

Refer to the Build Medusa Application guide for next steps.

Options#

OptionDescription

--admin-only

Whether to build only the admin to host it separately. If this option is not passed, the admin is built to the .medusa/server/public/admin directory. When this option is passed, the admin is built to the .medusa/admin directory instead.


Build Medusa Admin#

By default, the Medusa Admin is built to the .medusa/server/public/admin directory.

If you want a separate build to host the admin as a standalone application, such as on Vercel, pass the --admin-only option as explained in the Options section. This outputs the admin to the .medusa/admin directory instead.

Was this page helpful?
Ask Anything
Ask any questions about Medusa. Get help with your development.
You can also use the Medusa MCP server in Cursor, VSCode, etc...
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break