Node.js

Mayros requires Node 22 or newer. The installer script will detect and install Node automatically — this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs).

Check your version

bash
node -v

If this prints v22.x.x or higher, you're good. If Node isn't installed or the version is too old, pick an install method below.

Install Node

Homebrew (recommended):

bash
brew install node

Or download the macOS installer from nodejs.org.

Troubleshooting

mayros: command not found

This almost always means npm's global bin directory isn't on your PATH.

1

Find your global npm prefix

bash
npm prefix -g
2

Check if it's on your PATH

bash
echo "$PATH"

Look for <npm-prefix>/bin (macOS/Linux) or <npm-prefix> (Windows) in the output.

3

Add it to your shell startup file

Add to ~/.zshrc or ~/.bashrc:

bash
export PATH="$(npm prefix -g)/bin:$PATH"

Then open a new terminal (or run rehash in zsh / hash -r in bash).

Permission errors on npm install -g (Linux)

If you see EACCES errors, switch npm's global prefix to a user-writable directory:

bash
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Add the export PATH=... line to your ~/.bashrc or ~/.zshrc to make it permanent.