Install on Linux

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.

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_linux_amd64.tar.gz
tar -xzf nanocl_0.18.0_linux_amd64.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

Debian/Ubuntu

A .deb package is also available for Debian-based distributions like Debian and Ubuntu.

curl -LO https://github.com/next-hat/nanocl/releases/download/nanocl-0.18.0/nanocl_0.18.0_amd64.deb
sudo dpkg -i nanocl_0.18.0_amd64.deb

Compile from source

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.