Install NIC

Nebari Infrastructure Core (NIC) is a CLI that sets up a production-grade Kubernetes cluster and installs the platform essentials that run on top of it. It is the foundational layer of the Nebari ecosystem, that includes platform essentials like authentication (SSO), user management, observability, TLS certification, and more.

You can set up software packs (like the data science pack for specific tools like JupyterLab) on top of this layer. Learn more about how different Nebari projects and components interact in NKP architecture.

Install

Each option below installs the latest release.

pixi

If you use pixi on macOS, Linux, or Windows, run:

pixi global install -c https://prefix.dev/github-releases nebari-infrastructure-core

Homebrew (macOS)

If you use Homebrew, run:

brew install nebari-dev/tap/nic

Manual download

From the latest NIC release, download the archive for your platform.

Linux/MacOS: extract the tarball, replacing the file name with the one you downloaded:

tar -xzf nebari-infrastructure-core_<version>_<os>_<arch>.tar.gz

Move it to an appropriate folder on PATH:

sudo mv nic /usr/local/bin/

Ensure this location is on your user PATH with echo $PATH. If not, you can add it to PATH with export PATH=$PATH:/path/to/dir.

MacOS verification error

If you see a message Apple could not verify "nic" is free of malware that may harm your Mac or compromise your privacy, explicitly allow it:

• Go to: Settings > Privacy & Security
• Scroll down to the Security section, and find the "nic" was blocked ...
• Click on the "Open Anyway" button

Windows: extract the zip file, and add nic.exe to your PATH.

To add to PATH, search for "Edit environment variables for your account" on the system settings page.

Verify the installation

Ensure the installation worked with the help command. It should display a message similar to the following.

nic --help

Output

Nebari Infrastructure Core (NIC) is a standalone CLI tool that manages
cloud infrastructure for Nebari using native cloud SDKs with declarative semantics.

Usage:
  nic [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  deploy      Deploy infrastructure based on configuration file
  destroy     Destroy cloud infrastructure
  help        Help about any command
  kubeconfig  Generate kubeconfig for the deployed Nebari cluster
  outputs     Print the deployed platform's entry points
  validate    Validate configuration file
  version     Show version information

Flags:
  -h, --help   help for nic

Use "nic [command] --help" for more information about a command.

You can also install NIC from source for development and testing.