Install Nanocl

This page provides an overview of how to install Nanocl.

Prerequisites

Nanocl components run inside containers, so a container engine is required.
Nanocl officially supports Docker , and it also works with Podman .

Docker

Follow the official Docker installation guide  for your system.
On Windows and macOS, use Docker Desktop .

Podman

Since Podman provides a Docker-compatible API, Nanocl can run with Podman as well.
If you prefer Podman, install it using the official documentation .

Supported platforms

Only the CLI (nanocl) ships prebuilt for a subset of platforms:

• Linux: amd64
• macOS: aarch64 (Apple Silicon)
• Windows: amd64

Other platforms and architectures can install from source via crates.io . See the prerequisites listed on that page before running Cargo.

Installation guides

• Install on Linux
• Install on MacOS
• Install on Windows

Release channels

Nanocl offers two update channels: stable and nightly.

• Stable: latest releases intended for general availability.
• Nightly: pre-release builds for testing upcoming features.

Support

Nanocl is an open-source project supported by Next Hat  and the community.
For details and contributions, see the GitHub repository .

Licensing

Nanocl is open source  and dual licensed under the Apache License, Version 2.0  and the MIT license .