Skip to content

fnm list Command Guide

The fnm list command is used to view installed Node.js versions, and fnm list-remote is used to view available remote versions.

fnm list

List locally installed Node.js versions.

Command Syntax

bash
fnm list [OPTIONS]

Alias: ls

Usage Examples

bash
fnm list

Output example:

* v20.10.0 default
  v18.19.0
  v16.20.2
  • * indicates the currently used version
  • default indicates the default version

fnm list-remote

List all available remote Node.js versions.

Command Syntax

bash
fnm list-remote [OPTIONS]

Alias: ls-remote

Options

--filter

Filter by version number or semver range:

bash
# Filter by major version
fnm list-remote --filter=18

# Filter by minor version
fnm list-remote --filter=18.17

# Use semver range
fnm list-remote --filter=">=18.0.0 <20.0.0"

--lts

Show only LTS versions:

bash
# Show all LTS versions
fnm list-remote --lts

# Show specific LTS version
fnm list-remote --lts=iron

--latest

Show only the latest version:

bash
fnm list-remote --latest

--sort

Set sorting method:

bash
# Ascending (default)
fnm list-remote --sort=asc

# Descending
fnm list-remote --sort=desc

--node-dist-mirror

Specify mirror source:

bash
fnm list-remote --node-dist-mirror=https://npmmirror.com/mirrors/node

Usage Examples

bash
# List all versions
fnm list-remote

# List only LTS versions
fnm list-remote --lts

# List Node.js 18.x versions
fnm list-remote --filter=18

# List latest versions
fnm list-remote --latest

# List versions in descending order
fnm list-remote --sort=desc

Output Interpretation

fnm list Output

* v20.10.0 default
  v18.19.0
  v16.20.2
SymbolMeaning
*Currently used version
defaultDefault version
No markerInstalled but not in use

fnm list-remote Output

v20.10.0 (Iron)
v20.9.0 (Iron)
v18.19.0 (Hydrogen)
v18.18.2 (Hydrogen)
...

The names in parentheses are LTS version codenames.

Common Combinations

View Installable LTS Versions

bash
fnm list-remote --lts --latest

View Latest Minor Version for Specific Major Version

bash
fnm list-remote --filter=18 --latest

View Installed Versions

bash
fnm list

Common Issues

List Too Long

bash
# Use filtering
fnm list-remote --filter=20

# Only view latest
fnm list-remote --latest

# Only view LTS
fnm list-remote --lts

Cannot Fetch Remote List

bash
# Check network connection
curl -I https://nodejs.org/dist/

# Use mirror
fnm list-remote --node-dist-mirror=https://npmmirror.com/mirrors/node