Skip to content

Installing Nebari

Updated 3 min read

This installation guide provides the basic instructions to install the Nebari deployer package CLI for the first time, and assumes you are already familiar with the Conda and Python packaging ecosystems. If you are already familiar with Nebari and would like information on advanced configuration options, skip to the Advanced Configuration section in this documentation.

Pre-requisites

Section titled “Pre-requisites”

Nebari heavily depends on Terraform and Python. The installation of the Terraform binary is built-in within the Nebari source code, and it is automatically downloaded during the first execution. Currently, only Linux and macOS are supported. Windows is only supported through the “Windows Subsystem for Linux” ("WSL").

How to install the Nebari Package

Section titled “How to install the Nebari Package”

See Environment Management for best practices for using conda and pip to control your deployment environment.

There are currently two ways to install the Nebari CLI:

  1. You can install Nebari directly from the Python Package Index (PyPI) using pip. For most common architectures and platforms (Linux x86-64 and macOS x86-64), pip will download and install the most recent version available.

    Terminal window
    python3 -m pip install nebari

  2. Nebari is also available at conda-forge and can be installed using the conda package manager by running the following command:

    Terminal window
    conda install nebari -c conda-forge

    if you prefer mamba, you can use the following command:

    Terminal window
    mamba install nebari

Verify installation

Section titled “Verify installation”

You can verify that the Nebari package is properly installed and you can execute the client commands by running:

Terminal window
nebari --help

A representation of the output generated when Nebari help command argument is executed, the output contains a list of the available commands and their use.

What's next?

Section titled “What's next?”

Nebari Init and Guided Init

Section titled “Nebari Init and Guided Init”

Nebari Init creates and initializes your Nebari configuration. Guided init does the same but you can have a step-by-step experience while running it.

You can pass the --help flag to the init command to check all the arguments and options available for it.

Terminal window
nebari init --help

A representation of the output generated when Nebari init help command is executed, the output contains a list of the available options and arguments and their use.

Next steps?

Section titled “Next steps?”

Need more information before deploying Nebari? Check out the following sections in the documentation:

Already made your mind about deployment? Check our handy how-to-guides: