Nanocl post installation instruction

This section contains the required procedures for configuring Nanocl after installation.

Create a Unix group for Nanocl

The Nanocl daemon binds to a Unix socket instead of a TCP port.
By default that Unix socket is owned by the user root and group nanocl and other users can only access it using sudo or by being in nanocl group.

If you don't want to preface the nanocl command with sudo, create a Unix group called nanocl and add users to it. When the Nanocl daemon starts, it creates a Unix socket accessible by members of the nanocl group.

sudo groupadd nanocl
sudo usermod -aG nanocl $USER
newgrp nanocl

Install Nanocl Components

You installed the CLI now we need to spin up Nanocl components. It's use a default installation template that you can find here Nanocl have a strong docker support so it will detect automatically if you are running docker or docker desktop and detect the unix socket to use. But for some reason if you want to use a custom unix socket you can pass the --docker-host argument to the install command as follow

nanocl install --docker-host unix:///var/run/docker.sock

If you are using podman you need to specify the --docker-host argument as follow

nanocl install --docker-host unix:///var/run/podman/podman.sock

You can also choose the group assiociated to the unix socket by passing the --group argument to the install command as follow

nanocl install --group my-custom-group

Test if everything is good

nanocl version
nanocl cargo run my-cargo nginx:latest

Congratz you are now ready to you use Nanocl !