a12d737d1c
* docs: rearranged and removed installation section > Removed "Prerequisite Background Knowledge" section > Created "Required Tools" and "Optional Tools" sections > Moved "Node.js", "Git", and "Medusa CLI" to Required Section > "PostgreSQL" and "Redis" to "Optional Section" * removed links from heading * Removed Lists under required tools * added text below headline
279 lines
9.3 KiB
Plaintext
279 lines
9.3 KiB
Plaintext
import styles from './development.module.css';
|
||
import Tabs from '@theme/Tabs';
|
||
import TabItem from '@theme/TabItem';
|
||
|
||
# Set up your development environment
|
||
|
||
This document will guide you to set up 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
|
||
|
||
:::info
|
||
|
||
Node.js is an environment that can execute JavaScript code outside of the browser, making it possible to run on a server.
|
||
|
||
Node.js has a bundled package manager called NPM. NPM helps you install "packages" which are small pieces of code that you can leverage in your Node.js applications. Medusa's core is itself a package distributed via NPM and so are all of the plugins that exist around the core.
|
||
|
||
:::
|
||
|
||
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.
|
||
|
||
:::caution
|
||
|
||
Medusa supports versions 14 and 16 of Node.js. You can check your Node.js version using the following command:
|
||
|
||
```bash
|
||
node -v
|
||
```
|
||
|
||
:::
|
||
|
||
<Tabs groupId="operating-systems" wrapperClassName={styles.osTabs}>
|
||
<TabItem value="windows" label="Windows" default>
|
||
|
||
You can install the executable directly from [the Node.js website](https://nodejs.org/en/#home-downloadhead).
|
||
|
||
For other approaches, you can check out [Node.js’s guide](https://nodejs.org/en/download/package-manager/#windows-1).
|
||
|
||
</TabItem>
|
||
<TabItem value="linux" label="Linux">
|
||
|
||
You can use the following commands to install Node.js on Ubuntu:
|
||
|
||
```bash
|
||
#Ubuntu
|
||
sudo apt update
|
||
sudo apt install nodejs
|
||
```
|
||
|
||
For other Linux distributions, you can check out [Node.js’s guide](https://nodejs.org/en/download/package-manager/).
|
||
|
||
</TabItem>
|
||
<TabItem value="macos" label="macOS">
|
||
|
||
You can use the following commands to install Node.js on macOS:
|
||
|
||
<Tabs>
|
||
<TabItem value="homebrew" label="Homebrew">
|
||
|
||
```bash
|
||
brew install node
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="no-homebrew" label="Without Homebrew">
|
||
|
||
```bash
|
||
curl "https://nodejs.org/dist/latest/node-${VERSION:-$(wget -qO- https://nodejs.org/dist/latest/ | sed -nE 's|.*>node-(.*)\.pkg</a>.*|\1|p')}.pkg" > "$HOME/Downloads/node-latest.pkg" && sudo installer -store -pkg "$HOME/Downloads/node-latest.pkg" -target "/"
|
||
```
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
For other approaches, you can check out [Node.js’s guide](https://nodejs.org/en/download/package-manager/#macos).
|
||
|
||
:::tip
|
||
|
||
Make sure that you have Xcode command line tools installed; if not, run the following command to install it: `xcode-select --install`
|
||
|
||
:::
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
### Git
|
||
|
||
:::info
|
||
|
||
Git is a version control system that keeps track of files within a project and makes it possible to do things like going back in history if you have made mistakes or collaborate with teammates without overriding each other's work.
|
||
|
||
:::
|
||
|
||
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.
|
||
|
||
<Tabs groupId="operating-systems" wrapperClassName={styles.osTabs}>
|
||
<TabItem value="windows" label="Windows" default>
|
||
|
||
To install Git on Windows, you need to [download the installable package](https://git-scm.com/download/win).
|
||
|
||
</TabItem>
|
||
<TabItem value="linux" label="Linux">
|
||
|
||
For Debian/Ubuntu, you can use the following command:
|
||
|
||
```bash
|
||
apt-get install git
|
||
```
|
||
|
||
As for other Linux distributions, please check [git’s guide](https://git-scm.com/download/linux).
|
||
|
||
</TabItem>
|
||
<TabItem value="macos" label="macOS">
|
||
|
||
You should already have Git installed as part of the Xcode command-line tools.
|
||
|
||
However, if for any reason you need to install it manually, you can install it with Homebrew:
|
||
|
||
```bash
|
||
brew install git
|
||
```
|
||
|
||
You can also check out [git’s guide](https://git-scm.com/download/mac) for more installation options.
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
### 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:
|
||
|
||
```bash npm2yarn
|
||
npm install @medusajs/medusa-cli -g
|
||
```
|
||
|
||
## Optional Tools
|
||
|
||
These tools are not required to have to run a Medusa server, but we highly recommend that you have them installed.
|
||
|
||
### PostgreSQL
|
||
|
||
:::info
|
||
|
||
PostgreSQL is an open-source relational database system with more than 30 years of active development. It is robust, reliable, and ensures data integrity so there's no need to worry about those when you scale your project.
|
||
|
||
:::
|
||
|
||
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 server.
|
||
|
||
:::tip
|
||
|
||
After installing PostgreSQL, check out the [Configure your Server documentation](../usage/configurations.md#postgresql-configurations) to learn how to configure PostgreSQL to work with Medusa.
|
||
|
||
:::
|
||
|
||
<Tabs groupId="operating-systems" wrapperClassName={styles.osTabs}>
|
||
<TabItem value="windows" label="Windows">
|
||
|
||
You can [download the PostgreSQL Windows installer](https://www.postgresql.org/download/windows/) from their website.
|
||
|
||
</TabItem>
|
||
<TabItem value="linux" label="Linux">
|
||
|
||
If you’re using Ubuntu, you can use the following commands to download and install PostgreSQL:
|
||
|
||
```bash
|
||
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
|
||
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
|
||
sudo apt-get update
|
||
sudo apt-get -y install postgresql
|
||
```
|
||
|
||
For other distributions, you can check out [PostgreSQL’s website for more guides](https://www.postgresql.org/download/linux/).
|
||
|
||
</TabItem>
|
||
<TabItem value="macos" label="macOS">
|
||
|
||
You can download PostgreSQL on your macOS using [the installer on their website](https://www.postgresql.org/download/macosx/).
|
||
|
||
</TabItem>
|
||
<TabItem value="docker" label="Docker">
|
||
|
||
Make sure the Docker Desktop app is running, then run the following command to quickly spin up a PostgreSQL instance:
|
||
|
||
```bash
|
||
docker run --name postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=medusa-docker -p 5432:5432 -d postgres
|
||
```
|
||
|
||
Where:
|
||
|
||
- `--name` creates a new container named `postgres`.
|
||
- `-e` creates environment variables `POSTGRES_USER`, `POSTGRES_PASSWORD` and `POSTGRES_DB`. These will be used to set up a database named `medusa-docker` with the username and password being `postgres`.
|
||
- `-p` maps the container port `5432` to the external host `5432`. This allows you to connect to the database server from outside of the container.
|
||
- `-d` enables Docker to run the container in the background.
|
||
- The last section of the command, `postgres` grabs the latest postgres image from the Docker hub.
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
### Redis
|
||
|
||
:::info
|
||
|
||
Redis is an open-source in-memory data structure store. It can be used for distributing and emitting messages and caching, among other purposes.
|
||
|
||
:::
|
||
|
||
Medusa uses Redis as the event queue in the server. 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 server, then it will work without any events-related features.
|
||
|
||
:::tip
|
||
|
||
After installing Redis, check out the [Configure your Server documentation](../usage/configurations.md#redis) to learn how to configure Redis to work with Medusa.
|
||
|
||
:::
|
||
|
||
<Tabs groupId="operating-systems" wrapperClassName={styles.osTabs}>
|
||
<TabItem value="windows" label="Windows">
|
||
|
||
To use Redis on Windows, you must have [Windows Subsystem for Linux (WSL2) enabled](https://docs.microsoft.com/en-us/windows/wsl/install). 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:
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="linux" label="Linux">
|
||
|
||
If you use Ubuntu you can use the following commands to install Redis:
|
||
|
||
```bash
|
||
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
|
||
|
||
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
|
||
|
||
sudo apt-get update
|
||
sudo apt-get install redis
|
||
|
||
## Start Redis server
|
||
sudo service redis-server start
|
||
```
|
||
|
||
For other distributions, you can check out [Redis’ guide on this](https://redis.io/docs/getting-started/installation/install-redis-on-linux/).
|
||
|
||
</TabItem>
|
||
<TabItem value="macos" label="macOS">
|
||
|
||
You can install Redis on macOS using Homebrew with the following command:
|
||
|
||
```bash
|
||
brew install redis
|
||
|
||
## Start Redis server
|
||
brew services start redis
|
||
```
|
||
|
||
To install Redis without Homebrew you can check out [Redis’s guide on installing it from source](https://redis.io/docs/getting-started/installation/install-redis-from-source/).
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
## What’s Next 🚀
|
||
|
||
- Learn how to [configure your Medusa server](../usage/configurations.md).
|
||
- Learn how to install a storefront with [Next.js](../starters/nextjs-medusa-starter.md) or [Gatsby](./../starters/gatsby-medusa-starter.md).
|
||
- Learn how to install the [Medusa Admin](../admin/quickstart.md).
|