Skip to main content

Prepare Development Environment

This document will guide you to prepare your development environment to efficiently and properly use Medusa.

Required Tools

To get your development environment ready you need to install the following tools:


Node.js is the environment that makes it possible for Medusa to run, so you must install Node.js on your computer to start Medusa development.

Medusa supports versions 14 and 16 of Node.js. You can check your Node.js version using the following command:

node -v

You can install the executable directly from the Node.js website.

For other approaches, you can check out Node.js’s guide.


Medusa uses Git behind the scenes when you create a new project so you'll have to install it on your computer to get started.

To install Git on Windows, you need to download the installable package.

Medusa CLI

The final installation required to get started with Medusa is the Medusa CLI. It is an NPM package you can install globally on your machine to get instant access to commands that help you manage and run your Medusa project.

You can install Medusa’s CLI with the following command:

npm install @medusajs/medusa-cli -g

You can check that Medusa was installed by running the following command:

medusa -v

If you run into any errors while installing the CLI tool, check out the troubleshooting guide.

Install Medusa Backend

If you're not interested in installing the optional tools and want to get started with Medusa quickly, check out the Medusa Backend Quickstart.

Optional Tools

These tools are not required to have to run a Medusa backend, but it's highly recommended that you have them installed.


Although you can use an SQLite database with Medusa which would require no necessary database installations, it is recommended to use a PostgreSQL database for your backend.

After installing PostgreSQL, check out the Configure your Backend documentation to learn how to configure PostgreSQL to work with Medusa.

You can download the PostgreSQL Windows installer from their website.


Medusa uses Redis as the event queue in the backend. If you want to use subscribers to handle events such as when an order is placed and perform actions based on the events, then you need to install and configure Redis.

If you don’t install and configure Redis with your Medusa backend, then it will work without any events-related features.

After installing Redis, check out the Configure your Backend documentation to learn how to configure Redis to work with Medusa.

To use Redis on Windows, you must have Windows Subsystem for Linux (WSL2) enabled. This lets you run Linux binaries on Windows.

After installing and enabling WSL2, if you use an Ubuntu distribution you can run the following commands to install Redis:

sudo apt-add-repository ppa:redislabs/redis
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install redis-server

## Start Redis server
sudo service redis-server start

See Also