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
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