Midaz Console runs on Node.js and uses npm to manage its dependencies — but if you’re not familiar with these tools yet, don’t worry. You don’t need a tech background to get started. This guide walks you through the installation step by step.

🧠 What are Node.js and npm?

Here’s the short version:

• Node.js lets your computer run JavaScript outside the browser. It’s what powers the Midaz Console.
• npm (Node Package Manager) comes bundled with Node.js and takes care of installing everything the Console needs to run smoothly.

You don’t need to dive deep into how they work — just know they’re essential, and setting them up takes only a few minutes.

🧰 What You’ll Need

• A computer running Windows, macOS, or Linux
• Access to a terminal or command prompt

Once installed, you’ll be able to run node and npm from your terminal — just like we do in the Midaz Console installation.

Installation Steps

The setup depends on your operating system. Follow the steps that match your device:

🪟 Windows

1. Download Node.js
   Visit nodejs.org and download the LTS (Long-Term Support) version.

2. Install
   Run the file you just downloaded. You can safely keep all the default settings.

3. Restart your computer (if prompted)

4. Check your setup
   Open the Command Prompt (search for cmd in the Start menu) and run:

   Bash

   node -v
   npm -v
   

   If you see version numbers (like v18.x.x), you’re ready to go.

🍎 macOS

1. Download Node.js
   Head to nodejs.org and grab the LTS version for macOS.

2. Install
   Open the .pkg file and follow the instructions.

3. Open your Terminal
   Press Cmd + Space, type Terminal, and hit Enter.

4. Check your setup

   Bash

   node -v
   npm -v
   

   If both return version numbers, you're all set.

🐧 Ubuntu or Debian

In your Terminal, run:

sudo apt update
sudo apt install nodejs npm -y

Then check if everything installed correctly:

node -v
npm -v

❗

Need a newer version?

If your Node.js version is below v18, we recommend upgrading with nvm (Node Version Manager). It gives you flexibility and helps avoid version issues.
Follow this guide on GitHub for a quick setup.

✅ Next Step

Now that Node.js and npm are installed, you’re ready to set up Midaz Console and start building.