Skip to content
Documentation
Open the panel

PanelOrganization

Nodes

A node is a machine the agents of the organization run on. It can be a droplet on a DigitalOcean account of the organization, a server in its Hetzner Cloud project, or a host of your own: Linux with Docker or a Windows PC.

1

Step 1: Open Nodes

Click Nodes in the header of the organization. The table shows the State of each node, its Provider, the number of Agents and when it was last seen. Every agent is placed on a node when it is created and stays on it. Click the name of a node to open its page.

The Nodes tab
The Nodes tab
2

Step 2: Choose where the node runs

Click Add node and pick DigitalOcean, Hetzner or Own host. DigitalOcean and Hetzner need a provider account of that kind, which you add on the Providers tab.

Picking the kind of node
Picking the kind of node
3

Step 3: A node on DigitalOcean

Type the Name, pick the Provider account, the Region and the Droplet size (at least 2 GB of memory), and set the Agents volume in GB. Click Create node. The platform creates the droplet, its volume and its firewall, then installs the node. This takes a few minutes, and DigitalOcean bills the provider account.

The form of a node on DigitalOcean
The form of a node on DigitalOcean
4

Step 4: A node at Hetzner

Pick Hetzner, type the Name, pick the Provider account, the Location and the Server type, then set the Agents volume. A type gives its CPUs, memory, x86 or ARM architecture and monthly price in euros in the chosen location, without the volume and the IPv4 address. Click Create node: the platform creates the server, its volume and its firewall, and Hetzner bills the provider account.

The form of a node at Hetzner
The form of a node at Hetzner
5

Step 5: A node on a host of your own

Pick Own host, type the Name, such as build-02, and click Create node.

The form of a node on a host of your own
The form of a node on a host of your own
6

Step 6: Install the node

The panel shows the Registration token and the commands of the installer. The token is shown once only and works for one registration. Pick the Operating system, copy the commands and run them on the host: on Linux as a user with sudo, on Windows in PowerShell as administrator. The node joins the organization once its service connects.

The registration token and the installer commands
The registration token and the installer commands

Until the node joins, its state is waiting to join. When the token expired or got lost, click New registration token on the page of the node.

Matches the panel at cloud.kikimora.dev.