diff --git a/docs/content/deployments/admin/deploying-on-netlify.md b/docs/content/deployments/admin/deploying-on-netlify.md
index f6be655299..3640efad28 100644
--- a/docs/content/deployments/admin/deploying-on-netlify.md
+++ b/docs/content/deployments/admin/deploying-on-netlify.md
@@ -16,9 +16,8 @@ Additionally, this documentation does not cover how to deploy the Medusa server.
### Needed Accounts
-You need a Netlify account to deploy the Medusa Admin. If you don’t have one, you can create one on [Netlify’s website](https://app.netlify.com/signup?_ga=2.249228995.556918419.1656505909-2004101041.1655191129).
-
-Additionally, you need a GitHub account where you will host the repository for the Medusa admin. You can create it on [GitHub’s website](https://github.com/signup).
+- A [Netlify](https://app.netlify.com/signup) account to deploy the Medusa Admin.
+- A [GitHub](https://github.com/signup) account where you will host the repository for the Medusa admin.
:::tip
@@ -28,7 +27,7 @@ If you want to use another Git Provider, it’s possible to follow along with th
### Required Tools
-Git’s CLI tool is required while following along with this tutorial. You can follow [this documentation to learn how to install it for your operating system](../../tutorial/0-set-up-your-development-environment.mdx#git).
+- Git’s CLI tool. You can follow [this documentation to learn how to install it for your operating system](../../tutorial/0-set-up-your-development-environment.mdx#git).
## Create GitHub Repository
diff --git a/docs/content/deployments/server/deploying-on-heroku.mdx b/docs/content/deployments/server/deploying-on-heroku.mdx
index 26730927ca..e9e5e4073f 100644
--- a/docs/content/deployments/server/deploying-on-heroku.mdx
+++ b/docs/content/deployments/server/deploying-on-heroku.mdx
@@ -18,51 +18,24 @@ Alternatively, you can use this button to deploy the Medusa server to Heroku dir
## Prerequisites
-Before you start with this guide, you must have a Medusa server installed locally.
+### Medusa Server
-To install a Medusa server, follow our [Quickstart guide](../../quickstart/quick-start.md).
+It is assumed that you already have a Medusa server installed locally. If you don’t, please follow our [quickstart guide](../../quickstart/quick-start.md).
+
+Furthermore, your Medusa server should be configured to work with PostgreSQL and Redis. You can follow the [Configure your Server documentation](../../usage/configurations.md) to learn how to do that.
+
+### Needed Accounts
+
+- A [Heroku](https://heroku.com/) account.
+
+### Required Tools
+
+- Git’s CLI tool. You can follow [this documentation to learn how to install it for your operating system](../../tutorial/0-set-up-your-development-environment.mdx#git).
+- Heroku's CLI tool. You can follow [Heroku's documentation to learn how to install it for your operating system](https://devcenter.heroku.com/articles/heroku-cli).
## How to Deploy Your Medusa Server on Heroku
-### 1. Install the Heroku CLI
-
-Install the Heroku CLI tool using the instructions that belong to your operating system.
-
-
-
-
-Download the appropriate installer for your Windows installation:
-
-[64-bit installer](https://cli-assets.heroku.com/heroku-x64.exe)
-
-[32-bit installer](https://cli-assets.heroku.com/heroku-x86.exe)
-
-
-
-
-For Ubuntu, you can use the following command:
-
-```bash
-sudo snap install --classic heroku
-```
-
-As for other Linux distributions, please check [Heroku's guide](https://devcenter.heroku.com/articles/heroku-cli#standalone-installation-with-a-tarball).
-
-
-
-
-For macOS you can install Heroku's CLI tool using Homebrew:
-
-```bash
-brew tap heroku/brew && brew install heroku
-```
-
-For other installation options, please check [Heroku's guide](https://devcenter.heroku.com/articles/heroku-cli#standalone-installation-with-a-tarball)
-
-
-
-
-### 2. Login to Heroku from your CLI
+### 1. Login to Heroku from your CLI
Before you can create an app with Heroku, you must login with the CLI tool:
@@ -72,7 +45,7 @@ heroku login
Depending on your operating system, you must follow either the instructions in your terminal or a page in your browser will open.
-### 3. Create an App with Heroku
+### 2. Create an App with Heroku
In the root directory of your Medusa server, run the following commands to create an app on Heroku and add it as a remote origin:
@@ -83,7 +56,7 @@ heroku git:remote -a
Where `` is the name of the app you'll create. You can use any name you want.
-### 4. Install Postgresql and Redis on Heroku
+### 3. Install Postgresql and Redis on Heroku
Medusa requires a Postgres database and a Redis instance to work. You can add those to your Heroku app using Add-ons.
@@ -131,7 +104,7 @@ heroku addons:create upstash-redis
This uses the free plan of Upstash. Make sure to check out [more information regarding the plans and pricing of Upstash](https://elements.heroku.com/addons/upstash-redis#pricing).
-### 5. Configure Environment Variables on Heroku
+### 4. Configure Environment Variables on Heroku
Medusa requires a set of environment variables to be configured. You can learn more about Medusa's configurations in the [Configure your Medusa Server](../../usage/configurations.md) document.
@@ -202,7 +175,7 @@ heroku config:set STORE_CORS=
Where `` is the URL of your storefront.
-### 6. Configure Medusa Server
+### 5. Configure Medusa Server
Before jumping into the deployment, you need to configure your Medusa server to ensure it uses the previous environment variables and the recommended production configurations.
@@ -241,7 +214,7 @@ Update `scripts` to include the following scripts:
},
```
-### 7. Launch your Medusa Server
+### 6. Launch your Medusa Server
Finally, commit and push all changes to Heroku:
diff --git a/docs/content/deployments/storefront/deploying-gatsby-on-netlify.md b/docs/content/deployments/storefront/deploying-gatsby-on-netlify.md
index 8cf6526d4a..64751e30fb 100644
--- a/docs/content/deployments/storefront/deploying-gatsby-on-netlify.md
+++ b/docs/content/deployments/storefront/deploying-gatsby-on-netlify.md
@@ -16,9 +16,8 @@ Additionally, this documentation does not cover how to deploy the Medusa server.
### Needed Accounts
-You need a Netlify account to deploy the Gatsby storefront. If you don’t have one, you can create one on [Netlify’s website](https://app.netlify.com/signup).
-
-Additionally, you need a GitHub account where you will host the repository for the Gatsby storefront. You can create it on [GitHub’s website](https://github.com/signup).
+- A [Netlify](https://app.netlify.com/signup) account to deploy the Gatsby storefront.
+- A [GitHub](https://github.com/signup) account where you will host the repository for the Gatsby storefront.
:::tip
@@ -28,7 +27,7 @@ If you want to use another Git Provider, it’s possible to follow along with th
### Required Tools
-Git’s CLI tool is required while following along with this tutorial. You can follow [this documentation to learn how to install it for your operating system](../../tutorial/0-set-up-your-development-environment.mdx#git).
+- Git’s CLI tool. You can follow [this documentation to learn how to install it for your operating system](../../tutorial/0-set-up-your-development-environment.mdx#git).
## Create GitHub Repository