Resolve Errors Installing Medusa CLI

This troubleshooting guide covers common errors you may encounter when installing the Medusa CLI and how to resolve them.

NPM Error: EACCES Permissions Errors#

If you install the Medusa CLI tool with NPM and get a permission error, NPM proposes as a solution either re-installing NPM with a node version manager (nvm), or manually setting npm’s default directory.

Learn more in NPM’s documentation.


Powershell Error: command not found: medusa#

If you're using Powershell and you installed the CLI tool, but when you try to use it you get the error:

Terminal
command not found: medusa

Try closing your Powershell window and opening a new one.


Yarn Error: command not found: medusa#

If you install the Medusa CLI tool with Yarn, then try to use the CLI tool but get the error:

Terminal
command not found: medusa

You have to add Yarn’s install location to the PATH variable:

You can learn more in Yarn’s documentation.

Was this page helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or 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