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.
| Mode | Needs sudo | The node runs as | Files in | A compromised node can reach | Restart stops the VMs | Best for |
|---|---|---|---|---|---|---|
| Service user Recommended | Yes, to install | A system user, nodo | /nodo | The node’s own files and the network settings | Yes | A server or a machine that is always on |
| Without sudo | Only a few steps, shown before they run | You | ~/.local/share/nodo | Your files and the network settings | Yes | Your own computer, or to try Nodo |
| Root | Yes, to install | root | /nodo | Everything on the machine | No | The 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 thekvmgroup. Nodo goes in/nodo. - The node has the
CAP_NET_ADMINcapability only. Cloud Hypervisor, QEMU andvirtiofsdrun with no capabilities. - The installer adds you to the
nodogroup, so you can still edit/nodo/config.yaml. nodo updatekeeps the service user. To go back to a root node, run the installer again with--service-user root.nodo uninstalldoes 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/nodoand thenodocommand in~/.local/bin. You own all the files. If your shell does not findnodo, open a new login session. - Some steps need root: missing packages, a
/etc/subuidrange, the systemd unit and, on Ubuntu 23.10 and later, an AppArmor profile forvirtiofsd. The installer shows each command, saves them ininstall-privileged.sh, and runs them with sudo only if you say yes. To only show them, replace the finalbashof the command withbash -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 doctorwithout sudo only checks the node. To let it repair the service, runsudo ~/.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, alsonodo updateandnodo daemon restart. Their clients must start them again. - One machine runs one node: the three modes install the same
nodo.service. - Python, Java and
yqare 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.