> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kyberis.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Node.js and npx

> Install Node.js, npm, and npx before running Kyberis setup commands.

Kyberis setup commands use `npx` to run published npm packages without a permanent global install. Operating systems do not include `npx` by default. Install Node.js with npm first, then verify that `npx` is available.

Kyberis npm tools require Node.js 20 or newer.

## Check your current install

Run:

```bash theme={null}
node --version
npm --version
npx --version
```

If `node` is missing, the Node.js version is below `20`, or `npx` is missing, install or upgrade Node.js.

## macOS direct installer

Use the direct installer when you want the standard Node.js package from the Node.js project.

1. Open the [Node.js download page](https://nodejs.org/en/download).
2. Download the macOS installer for the latest LTS release.
3. Run the installer and accept the defaults.
4. Open a new terminal window.
5. Verify the install:

```bash theme={null}
node --version
npm --version
npx --version
```

You do not need Xcode command-line tools for the direct Node.js installer. You may still need them later if another npm package builds native extensions.

## macOS with Homebrew

Use Homebrew when you already manage developer tools with `brew`.

Install Xcode command-line tools first if they are not already installed:

```bash theme={null}
xcode-select --install
```

Install Homebrew from [brew.sh](https://brew.sh/) if `brew` is not available. Homebrew may print shell setup commands at the end of installation. Run those commands or open a new terminal before continuing.

Install Node.js:

```bash theme={null}
brew install node
```

Verify:

```bash theme={null}
node --version
npm --version
npx --version
```

## Windows

Use the Node.js installer when you want the standard Windows setup.

1. Open the [Node.js download page](https://nodejs.org/en/download).
2. Download the Windows installer for the latest LTS release.
3. Run the installer and keep npm selected.
4. Open a new PowerShell window.
5. Verify the install:

```powershell theme={null}
node --version
npm --version
npx --version
```

If your organization uses Windows Package Manager, you can also install Node.js from PowerShell:

```powershell theme={null}
winget install OpenJS.NodeJS.LTS
```

Open a new PowerShell window after installation, then run the verification commands again.

## Linux

Use your distribution package manager or the install method your organization supports. Make sure the installed Node.js version is `20` or newer. Some long-term-support Linux distributions ship older Node.js packages.

On Debian or Ubuntu, check the packaged version first:

```bash theme={null}
apt-cache policy nodejs
```

If the available version is `20` or newer, install it:

```bash theme={null}
sudo apt update
sudo apt install nodejs npm
```

On Fedora, RHEL, or compatible distributions, install Node.js and npm with:

```bash theme={null}
sudo dnf install nodejs npm
```

Verify:

```bash theme={null}
node --version
npm --version
npx --version
```

If your package manager installs an older Node.js version, use the [Node.js download page](https://nodejs.org/en/download) or your organization's approved Node.js package source to install Node.js 20 or newer.

## FreeBSD

Use FreeBSD packages when they provide Node.js 20 or newer. For the current LTS line, install the versioned Node.js and npm packages:

```bash theme={null}
sudo pkg install node24 npm-node24
```

Verify:

```bash theme={null}
node --version
npm --version
npx --version
```

If the package repository does not provide Node.js 20 or newer for your FreeBSD release, install a newer Node.js version from ports or from the [Node.js download page](https://nodejs.org/en/download), following your organization's normal FreeBSD package policy.

## Run Kyberis setup commands

After `npx` is available, continue with Kyberis setup:

<CardGroup cols={2}>
  <Card title="Set up Kyberis" icon="https://mintcdn.com/kyberis/c-TjxE2WqJIPZVhQ/icons/get-started.svg?fit=max&auto=format&n=c-TjxE2WqJIPZVhQ&q=85&s=9700ee6eb4e930bbec4390f60bf99d96" href="/install/overview" width="24" height="24" data-path="icons/get-started.svg" />

  <Card title="Install skills" icon="https://mintcdn.com/kyberis/c-TjxE2WqJIPZVhQ/icons/skill.svg?fit=max&auto=format&n=c-TjxE2WqJIPZVhQ&q=85&s=8f27afa1ae8b079155f39d54e121811a" href="/install/skills" width="24" height="24" data-path="icons/skill.svg" />

  <Card title="Connect MCP" icon="https://mintcdn.com/kyberis/c-TjxE2WqJIPZVhQ/icons/mcp.svg?fit=max&auto=format&n=c-TjxE2WqJIPZVhQ&q=85&s=7863df3c06b580b0bb617a65bf1f7b4a" href="/install/mcp" width="24" height="24" data-path="icons/mcp.svg" />
</CardGroup>