Installation Requirements

This page covers installing the basic installation requirements for Strapi.

Basic Installation Requirements

Strapi requires just installing Node.js. We recommend using version 10.x or later.

This is all that is needed before Strapi can get up and running on your development environment.

Install Node.js (and npm)

Strapi needs Node.js and npm installed. npm installs at the same time as Node.js. You can following the below instructions to install Node.js on Windows 10, Ubuntu 18.04 and Mac O/S Mojave.

Installation Instructions for each Operating System:

WINDOWS 10

Install Node.js (and npm) on Windows 10

There are several methods to install Node.js on Windows 10.

We will follow the most common download and installation procedure. These instructions are for Windows 10. (If you are installing on a different version of Windows or if you have trouble following these instructions, please review the official Node.js documentation.)

  1. Download the Windows Installer from the downloads page. You will need to choose the 32-bit or 64-bit version. We recommend the LTS (long-term support) version of Nodejs.
  2. Double-click the node-v10.x.x-x86.msi file icon. Click "Next" for the default options and to install Nodejs under the recommended and most common settings. After clicking "Next" several times, click "Install" to install node.js. When it is done installing, click "Finish".
  3. Verify both Node.js and npm have installed correctly. Open your Command Prompt:
    • Click your Start Button
    • In Search type, "cmd"
    • Then click on "Command Prompt".
    • Type the following commands in your Command Prompt

Verify Node.js has correctly installed:

node -v
## You should see "v10.x.x

Next, verify npm has correctly installed:

npm -v
## You should see "6.x.x"

MAC O/S 10.14 MOJAVE

Install Node.js (and npm) on Mac O/S X (Mojave)

There are multiple methods to install Node.js on Mac O/S X (Mojave).

We will follow the most common download and installation procedure. These instructions are for Mac O/S X (Mojave). (If you are installing on a different version of Mac O/S or if you have trouble following these instructions, please review the official Nodejs documentation.)

  1. Download the Mac O/S Installer from the downloads page. We recommend the LTS (long-term support) version of Nodejs.
  2. Launch the node-v10.x.x.pkg file icon. Click "Continue" for the default options and to install Nodejs under the recommended and most common settings. After clicking "Continue" several times, click "Install" to install node.js. When it is done installing, click "Close".
  3. Verify both Node.js and npm have installed correctly. Open your terminal prompt:
    • Open you Applications folder
    • Find and open the Utilities folder
    • Find "Terminal" and click on it to open it.
    • Type the following commands in your Terminal

Verify Node.js has correctly installed:

node -v
## You should see "v10.x.x"

Next, verify npm has correctly installed:

npm -v
## You should see "6.x.x"

UBUNTU 18.04

Install Node.js (and npm) on Ubuntu 18.04

There are multiple methods to install Node.js on Ubuntu 18.04.

We will follow the most common download and installation procedure. These instructions are for Ubuntu 18.04. (If you are installing on a different version of Ubuntu or a different Linux Distro or if you have trouble following these instructions, please review the official Nodejs documentation.)

  1. Install cURL and use cURL to download the nodejs (and npm) source code
sudo apt-get install curl
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
  1. Install node.js (and npm)
sudo apt-get install -y nodejs

Verify Node.js has correctly installed:

node -v
## You should see "v10.x.x"

Next, verify npm has correctly installed:

npm -v
## You should see "6.x.x"

NEXT STEPS

👏 Congrats, you are all set! Now that Node.js is installed you can proceed to the Quick start.