18 releases (11 breaking)

0.13.0 Dec 28, 2023
0.11.0 Nov 18, 2023
0.9.1-nightly Jun 27, 2023
0.3.0 Mar 20, 2023
0.1.8 Nov 21, 2022

#34 in HTTP server

Download history 27/week @ 2023-11-13 41/week @ 2023-11-20 49/week @ 2023-11-27 19/week @ 2023-12-04 2/week @ 2023-12-11 51/week @ 2023-12-18 66/week @ 2023-12-25 23/week @ 2024-01-01 2/week @ 2024-01-08 2/week @ 2024-01-15 2/week @ 2024-01-22 38/week @ 2024-01-29 1/week @ 2024-02-05 378/week @ 2024-02-12 489/week @ 2024-02-19

906 downloads per month




Stars Build With Chat on Discord

Tests Clippy


Test, Deploy, Scale, Monitor, Orchestrate

❓ Why Nanocl

Nanocl is all about easing your container and VM management with Rust-powered platform. With Nanocl, say goodbye to complex setups and hello to easy, efficient deployments. We stand for robust performance and efficiency with simplicity, trimming the bloat to keep your systems lean. Join us and help shape the future of cloud computing - it's about time things got a bit more rusty.

📙 Table of Contents

🚀 Key Benefits

  • Easy deployment and management
  • Significantly reduce the delay between writing code and shipping it to production
  • Efficiently manage and scale your infrastructure as your needs evolve
  • Enhance security by isolating services using namespaces and networks.
  • Enjoy peace of mind with automatic backups, zero downtime fail-over, and comprehensive log monitoring
  • Enjoy history tracking of your container and virtual machine configuration
  • Revert configuration as quickly as pressing a button
  • Build an entire CI/CD pipeline, from tests to high-availability production
  • Best ideas and practices from the community

🔧 Usage

Nanocl is designed to be easy to operate by mostly using Statefiles.
Statefiles are yaml files that define the state you want.
There is an example used to deploy our documentation:

ApiVersion: v0.12

# See all options:
# https://docs.next-hat.com/references/nanocl/cargo
- Name: doc
    Image: nh-doc:0.12.0

# See all options:
# https://docs.next-hat.com/references/nanocl/resource
- Name: docs.next-hat.com
  Kind: ncproxy.io/rule/v0.9
    - Domain: docs.next-hat.com
      Network: Public
      Ssl: cert.next-hat.com
      - Path: /
          Key: doc.nexthat.c
          Port: 80

To apply a state we can do it easily bu running nanocl state apply -s path|url
We can also revert a state by calling nanocl state rm -s path|url

📺 Demo

Demo of Nanocl in action when applying example/deploy_example.yml:

🧿 Architecture

Nanocl is designed in a micro services architecture several component are required and they are running as container included the Nanocl Daemon itself. The following components will be installed during nanocl setup and are required to ensure Nanocl functionnality:

  • nstore to save our state
  • ndaemon as REST API to manage everything
  • nmetrics to monitor cpu, memory and network usage
  • nproxy proxy to redirect traffic to our containers and virtual machines
  • ncproxy to update proxy configuration based on the current state
  • ndns to manage the dns entries for the containers and virtual machines
  • ncdns to update dns entries based on the current state

Simplified version of our architecture for a single node:

📚 Documentation

To learn more about Nanocl, you can take a look at the following resources:

📋 Requirements

To work properly Nanocl must have theses dependencies installed on the system:

💾 Installation

To install Nanocl, please refer to our online installation guide.

👨‍💻 Contributing

Every contribution is very welcome.

But to be abble to do so you need a dev environnement right ?
You can learn more about it on the contribution guide.
Also don't hesitate to join the discord if you have any question!


~1.5M SLoC