Setup Node.js with NVM

Install and manage Node.js 24.17.0 or later with NVM for local Hexabot development.

Hexabot v3 requires Node.js >= 24.17.0.

Use NVM to install and switch Node.js versions cleanly. This is the easiest setup for local Hexabot development.

If you want the full local setup flow, see Installation.

Install NVM

The steps below use Ubuntu. For other operating systems, use the official NVM install guide.

1. Update your package index:

sudo apt update

1. Install NVM:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

1. Restart your terminal.

Or load NVM in the current shell:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

1. Verify the installation:

nvm --version

Install Node.js 24.17.0 or later

Install the current minimum supported version:

nvm install 24.17.0

Set it as your default version:

nvm alias default 24.17.0

Use it in the current shell:

nvm use 24.17.0

Verify the active Node.js version:

node --version

The output should be v24.17.0 or later.