Installing Nu

There are lots of ways to get Nu up and running. You can download pre-built binaries from our release pageopen in new window, use your favourite package manageropen in new window, or build from source.

Pre-built binaries

Nu binaries are published for Linux, macOS, and Windows with each GitHub releaseopen in new window. Just download, extract the binaries, then copy them to a location on your PATH.

Package managers

Nu is available via several package managers:

Packaging statusopen in new window

For macOS and Linux, Homebrewopen in new window is a popular choice (brew install nushell).

For Windows:

The main Nushell binary is named nu (or nu.exe on Windows). After installation, you can launch it by typing nu.

Build from source

You can also build Nu from source. First, you will need to set up the Rust toolchain and its dependencies.

Installing a compiler suite

For Rust to work properly, you'll need to have a compatible compiler suite installed on your system. These are the recommended compiler suites:

Installing Rust

If we don't already have Rust on our system, the best way to install it is via rustupopen in new window. Rustup is a way of managing Rust installations, including managing using different Rust versions.

Nu currently requires the latest stable (1.66.1 or later) version of Rust. The best way is to let rustup find the correct version for you. When you first open rustup it will ask what version of Rust you wish to install:

Current installation options:

default host triple: x86_64-unknown-linux-gnu
default toolchain: stable
profile: default
modify PATH variable: yes

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation

Once we are ready, we press 1 and then enter.

If you'd rather not install Rust via rustup, you can also install it via other methods (e.g. from a package in a Linux distro). Just be sure to install a version of Rust that is 1.66.1 or later.

Dependencies

Debian/Ubuntu

You will need to install the "pkg-config" and "libssl-dev" package:

apt install pkg-config libssl-dev

RHEL based distros

You will need to install "libxcb", "openssl-devel" and "libX11-devel":

yum install libxcb openssl-devel libX11-devel

macOS

Using Homebrewopen in new window, you will need to install "openssl" and "cmake" using:

brew install openssl cmake

Build using crates.ioopen in new window

Nu releases are published as source to the popular Rust package registry crates.ioopen in new window. This makes it easy to build+install the latest Nu release with cargo:

> cargo install nu

That's it! The cargo tool will do the work of downloading Nu and its source dependencies, building it, and installing it into the cargo bin path so we can run it.

If you want to install with support for dataframes, you can install using the --features=dataframe flag.

> cargo install nu --features=dataframe

Once installed, we can run Nu using the nu command:

$ nu
/home/jt/Source>

Building from the GitHub repository

We can also build our own Nu from the latest source on GitHub. This gives us immediate access to the latest features and bug fixes. First, clone the repo:

> git clone https://github.com/nushell/nushell.git

From there, we can build and run Nu with:

> cd nushell
nushell> cargo build --workspace && cargo run

You can also build and run Nu in release mode:

nushell> cargo build --release --workspace && cargo run --release

People familiar with Rust may wonder why we do both a "build" and a "run" step if "run" does a build by default. This is to get around a shortcoming of the new default-run option in Cargo, and ensure that all plugins are built, though this may not be required in the future.

Contributors: Justin Ma, Reilly Wood, Andrés N. Robalino, Reilly Wood, dgalbraith, Adam Smith, Hofer-Julian, Ibraheem Ahmed, Jake Vossen, Rashil Gandhi, max-nextcloud, prrao87