Install fnm

fnm offers multiple installation methods. Choose the one that suits your operating system.

macOS

Using Homebrew (Recommended)

brew install fnm

Using curl Script

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

Using MacPorts

port install fnm

Windows

Using winget (Recommended)

winget install Schniz.fnm

Using Scoop

scoop install fnm

Using Chocolatey

choco install fnm

Using curl Script (Requires Git Bash or WSL)

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

Linux

Using curl Script (Recommended)

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

Using Homebrew

brew install fnm

Download from GitHub Releases

1. Visit fnm Releases page
2. Download the archive for your architecture
3. Extract and move the binary to a PATH directory

# Example: Install x86_64 architecture
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
unzip fnm-linux.zip -d /usr/local/bin
chmod +x /usr/local/bin/fnm

Configure Shell

After installation, you need to configure Shell environment variables.

Bash

Add the following to ~/.bashrc:

eval "$(fnm env --use-on-cd)"

Then reload the configuration:

source ~/.bashrc

Zsh

Add the following to ~/.zshrc:

eval "$(fnm env --use-on-cd)"

Then reload the configuration:

source ~/.zshrc

Fish

Add the following to ~/.config/fish/config.fish:

fnm env --use-on-c | source

Then reload the configuration:

source ~/.config/fish/config.fish

PowerShell

Add the following to the PowerShell profile:

fnm env --use-on-cd | Out-String | Invoke-Expression

You can open the profile with:

notepad $PROFILE

Verify Installation

After installation, verify that fnm is installed correctly:

fnm --version

Output similar to:

fnm 1.37.1

Environment Variable Configuration

fnm supports the following environment variables for custom configuration:

Environment Variable	Description	Default
FNM_DIR	fnm installation directory	~/.fnm
FNM_NODE_DIST_MIRROR	Node.js download mirror	https://nodejs.org/dist
FNM_LOGLEVEL	Log level	info
FNM_ARCH	Architecture override	System architecture
FNM_COREPACK_ENABLED	Enable Corepack	false

Using Mirror in China

In mainland China, you can configure a mirror to accelerate downloads:

export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Or add to Shell configuration file:

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

Next Steps

After installation, you can:

• Install Node.js - Use fnm to install your first Node.js version
• Command Reference - Learn all available commands
• Version Management - Learn how to manage multiple Node.js versions