Install Node.js on Linux

Node.js is required for running tools like CodeX CLI, Gemini CLI, and CC-Switch.

Method 1: Using fnm (Recommended)

fnm (Fast Node Manager) is the recommended way to install and manage Node.js versions.

Install fnm

curl -fsSL https://fnm.vercel.app/install | bash

Restart your terminal or source your profile:

source ~/.bashrc

Install Node.js

fnm install --lts
fnm use lts-latest
fnm default lts-latest

Verify

node -v
npm -v

Method 2: Using NodeSource Repository

Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

RHEL / CentOS / Fedora

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs

Verify

node -v
npm -v

Method 3: Using nvm

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

Restart your terminal, then:

nvm install --lts
nvm use --lts

Method 4: Using Package Manager

WARNING

System package managers often have outdated Node.js versions. Use fnm or NodeSource for the latest LTS version.

Ubuntu / Debian

sudo apt update
sudo apt install nodejs npm

Arch Linux

sudo pacman -S nodejs npm

Troubleshooting

node: command not found

• Restart your terminal after installation
• Check your PATH: echo $PATH
• For fnm: ensure eval "$(fnm env --use-on-cd)" is in your ~/.bashrc

Permission Errors with Global Installs

Instead of using sudo npm install -g, configure npm to use a user directory:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc