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.

caution

Nightly builds are experimental and may include breaking changes.

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.