Skip to Content

Install Nanocl on MacOS

Quick install

curl -fsSL https://download.next-hat.com/scripts/get-nanocl.sh | sh

This script downloads and installs the latest version of Nanocl for your platform. It does not require root privileges: it installs under ~/.nanocl and adds ~/.nanocl/env to your shell profile so the nanocl command is available in your user's PATH.

The script falls back to building from crates.io if no prebuilt binary is available for your platform. Man pages are not installed in that case.

Manual install

Get the CLI tarball

You can grab the Nanocl tarball directly from the GitHub releases page , or download and extract it:

curl -LO https://github.com/next-hat/nanocl/releases/download/nanocl-0.18.0/nanocl_0.18.0_mac_aarch64.tar.gz tar -xzf nanocl_0.18.0_mac_aarch64.tar.gz

Extracted directory layout:

. ├─ bin/ │ └─ nanocl (the nanocl binary) └─ share/ └─ man/ └─ man1/ (multiple man pages for nanocl and its subcommands)

Move the nanoclbinary and its man pages to the appropriate locations:

sudo mv ./bin/nanocl /usr/local/bin sudo mv ./share/man/man1/* /usr/local/share/man/man1

Compile from source

You need to install PostgreSQL first using Homebrew:

brew install libpq brew link --force libpq

If there is no release binary for your platform, you can compile Nanocl from source using Cargo.

Prerequisites:

  • Install the Rust toolchain .
  • Ensure OpenSSL and PostgreSQL client libraries are available.
cargo install nanocl

Verify installation

Verify that Nanocl is correctly installed by checking its version:

nanocl --version

Now be sure to follow the post installation steps to install nanocl components.

Last updated on