Install fnm on Linux

fnm has multiple installation methods on Linux. This guide will help you install fnm on various Linux distributions.

Installation Methods

Using curl Script (Recommended)

The simplest installation method:

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

After installation, follow the prompts to reload Shell or manually add to PATH:

export PATH="$HOME/.fnm:$PATH"
eval "$(fnm env --use-on-cd)"

Using Homebrew

If you have Homebrew installed on Linux:

brew install fnm

Manual Download

1. Visit fnm Releases page
2. Download the archive for your architecture:

# x86_64
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip

# ARM64
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-arm64.zip

3. Extract and install:

unzip fnm-linux.zip -d ~/.local/bin
chmod +x ~/.local/bin/fnm

Distribution-Specific Installation Guide

Ubuntu / Debian

# Method 1: Using curl script
curl -fsSL https://fnm.vercel.app/install | bash

# Method 2: Manual installation
sudo apt update
sudo apt install -y unzip
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
sudo unzip fnm-linux.zip -d /usr/local/bin
sudo chmod +x /usr/local/bin/fnm

CentOS / RHEL / Fedora

# Install dependencies
sudo dnf install -y unzip  # Fedora
# or
sudo yum install -y unzip  # CentOS/RHEL

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

# Or manual installation
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
sudo unzip fnm-linux.zip -d /usr/local/bin
sudo chmod +x /usr/local/bin/fnm

Arch Linux

# Using AUR helper
yay -S fnm-bin

# Or build from AUR
git clone https://aur.archlinux.org/fnm-bin.git
cd fnm-bin
makepkg -si

Alpine Linux

# Install dependencies
apk add bash curl unzip

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

# Or manual installation
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
unzip fnm-linux.zip -d ~/.local/bin
chmod +x ~/.local/bin/fnm

Configure Shell

Bash

Edit ~/.bashrc:

echo 'eval "$(fnm env --use-on-cd)"' >> ~/.bashrc
source ~/.bashrc

Zsh

Edit ~/.zshrc:

echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc

Fish

Edit ~/.config/fish/config.fish:

echo 'fnm env --use-on-c | source' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

Shell Completion

Bash Completion

# Install bash-completion (if not installed)
sudo apt install bash-completion  # Debian/Ubuntu
sudo dnf install bash-completion  # Fedora

# Add completion script
fnm completions --shell bash >> ~/.bashrc
source ~/.bashrc

Zsh Completion

# Create completion directory
mkdir -p ~/.zsh/completions

# Generate completion script
fnm completions --shell zsh > ~/.zsh/completions/_fnm

# Add to ~/.zshrc
fpath=(~/.zsh/completions $fpath)
autoload -U compinit && compinit

Fish Completion

fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

Using Mirror in China

In mainland China, it's recommended to configure a mirror to accelerate downloads:

# Add to Shell configuration file
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Or specify during eval
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Common mirrors:

Mirror Source	URL
npmmirror	https://npmmirror.com/mirrors/node
Tsinghua University	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs

Verify Installation

# Check fnm version
fnm --version

# Install Node.js
fnm install --lts

# Verify Node.js
node --version
npm --version

Common Issues

Command Not Found

# Check if fnm is in PATH
which fnm

# Manually add to PATH
export PATH="$HOME/.fnm:$PATH"

# Permanently add to PATH
echo 'export PATH="$HOME/.fnm:$PATH"' >> ~/.bashrc

Permission Issues

# Ensure fnm has execute permission
chmod +x ~/.fnm/fnm
# or
chmod +x /usr/local/bin/fnm

Download Failed

# Use mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install --lts

Next Steps

After installation, you can:

• Install Node.js - Use fnm to install Node.js
• Command Reference - Learn all available commands
• Version Management - Learn version management

Related Links

• Install fnm - General installation guide
• Windows Installation - Windows installation guide
• macOS Installation - macOS installation guide
• Ubuntu Uninstall - Ubuntu uninstall guide