diff --git a/book/installation.md b/book/installation.md index 93716248945..cdacf17514a 100644 --- a/book/installation.md +++ b/book/installation.md @@ -6,6 +6,8 @@ The main Nushell binary is named `nu` (or `nu.exe` on Windows). After installati @[code](@snippets/installation/run_nu.sh) +[[toc]] + ## Pre-built Binaries Nu binaries are published for Linux, macOS, and Windows [with each GitHub release](https://github.com/nushell/nushell/releases). Just download, extract the binaries, then copy them to a location on your PATH. @@ -74,13 +76,17 @@ Using [Homebrew](https://brew.sh/), you will need to install "openssl" and "cmak @[code](@snippets/installation/macos_deps.sh) -### Build using [crates.io](https://crates.io) +### Build from [crates.io](https://crates.io) using Cargo + +Nushell releases are published as source to the popular Rust package registry [crates.io](https://crates.io/). This makes it easy to build and install the latest Nu release with `cargo`: -Nu releases are published as source to the popular Rust package registry [crates.io](https://crates.io/). This makes it easy to build and install the latest Nu release with `cargo`: +```nu +cargo install nu +``` -@[code](@snippets/installation/cargo_install_nu.sh) +The `cargo` tool will do the work of downloading Nu and its source dependencies, building it, and installing it into the cargo bin path. -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. +Note that the default plugins must be installed separately when using `cargo`. See the [Plugins Installation](./plugins.html#core-plugins) section of the Book for instructions. ### Building from the GitHub repository diff --git a/book/plugins.md b/book/plugins.md index eebb73241bd..8b7fb067997 100644 --- a/book/plugins.md +++ b/book/plugins.md @@ -28,6 +28,18 @@ Core plugins are typically distributed with the Nushell release and should alrea ::: tip Installing using Cargo For example, when installing or upgrading Nushell directly from crates.io using `cargo install nu`, the corresponding core plugins for that version may also be installed or updated using `cargo install nu_plugin_`. + +To install all of the default plugins, from within Nushell run: + +```nu +[ nu_plugin_inc + nu_plugin_polars + nu_plugin_gstat + nu_plugin_formats + nu_plugin_query +] | each { cargo install $in } | ignore +``` + ::: ### Third-party Plugins