CELAUT Install Nodo

Run a Celaut Node

Install Nodo and join the decentralized network — discover peers, execute and orchestrate services, and turn your machine into shared, censorship-resistant compute.

Linux

There are three ways to install Nodo on Linux. They differ in the user that runs the node. All three install the same systemd service, nodo.service, which starts at boot and restarts if it fails.

Which one should I use?

Not sure? Use the service user. It is the best choice for a node that is always on, and the node does not run as your own user. Use the install without sudo if you want the node in your home directory and want to see each root command before it runs.

ModeNeeds sudoThe node runs asFiles inA compromised node can reachRestart stops the VMsBest for
Without sudo Only a few steps, shown before they runYou~/.local/share/nodoYour files and the network settingsYesYour own computer, or to try Nodo
Root Yes, to installroot/nodoEverything on the machineNoThe simplest setup, or VMs that must keep running when the node restarts

Service user Recommended

Run the installer with sudo, and name the user for the node:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/celaut-project/nodo/stable/install.sh | sudo bash -s -- --service-user nodo
  • The installer creates the system user nodo (home /var/lib/nodo) and adds it to the kvm group. Nodo goes in /nodo.
  • The node has the CAP_NET_ADMIN capability only. Cloud Hypervisor, QEMU and virtiofsd run with no capabilities.
  • The installer adds you to the nodo group, so you can still edit /nodo/config.yaml.
  • nodo update keeps the service user. To go back to a root node, run the installer again with --service-user root. nodo uninstall does not delete the user.
Check it
nodo statussudo nodo doctor
Update
sudo nodo update
Uninstall
sudo nodo uninstall

Without sudo

Run the installer as yourself, without sudo:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/celaut-project/nodo/stable/install.sh | bash
  • Nodo goes in ~/.local/share/nodo and the nodo command in ~/.local/bin. You own all the files. If your shell does not find nodo, open a new login session.
  • Some steps need root: missing packages, a /etc/subuid range, the systemd unit and, on Ubuntu 23.10 and later, an AppArmor profile for virtiofsd. The installer shows each command, saves them in install-privileged.sh, and runs them with sudo only if you say yes. To only show them, replace the final bash of the command with bash -s -- --no-input.
  • On a new machine, the installer can stop after it shows the packages to install. Install them, then run the same command again.
  • nodo doctor without sudo only checks the node. To let it repair the service, run sudo ~/.local/bin/nodo doctor.
Check it
nodo statusnodo doctor
Update
nodo update
Uninstall
nodo uninstall

Root

Run the installer with sudo. It does all the steps itself:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/celaut-project/nodo/stable/install.sh | sudo bash
  • The node runs as root. Nodo goes in /nodo.
  • The VMs keep running when the node restarts, also during nodo update.
Check it
nodo statussudo nodo doctor
Update
sudo nodo update
Uninstall
sudo nodo uninstall

Good to know

  • With a service user and without sudo, the VMs run inside nodo.service. A restart of the service stops all of them, also nodo update and nodo daemon restart. Their clients must start them again.
  • One machine runs one node: the three modes install the same nodo.service.
  • Python, Java and yq are installed under the node’s own directory, in all three modes.
  • Nodo shows the command that opens its gateway port in your firewall (ufw, firewalld). It does not change that firewall itself.
  • What each mode needs, and why: Rootless operation (ROOTLESS.md).
  • For a fully manual install, follow the manual guide.