Skip to content
Avaloi

Nodes

See the servers that run your sites, their capacity and health, and how a server you manage joins Avaloi.

A node is a server that runs sites. Open Settings, then Nodes, to see them. You need the nodes permission to see this page.

Open it

  1. Choose Settings in the sidebar.
  2. Choose Nodes.

Each row shows the node's status, region, provider, how much of its capacity is in use, how many sites it hosts, its agent version, and its last heartbeat.

A node marked Simulated is the demo node that runs test sites at no cost.

Read a node's capacity

Select a node's name to see its capacity in CPU, memory, and disk, its addresses, and its labels. Avaloi keeps 20 percent of every node free, so the headroom you see is what sites can still use.

No servers yet

Servers start after your first paid site. Until then the list is empty. Plans cannot be bought yet, so create a test site to explore Avaloi in the meantime. See Sites list and bulk actions.

Add a server you manage

Avaloi can run sites on a server you own. The server joins through an enrollment token and a bootstrap command. Today Avaloi staff create enrollment tokens, so ask support when you want to enroll a server.

This is how a token works:

  1. Staff choose Create enrollment token, enter a node name and a region, and select Create token.
  2. Avaloi shows the token and the bootstrap command once. Copy them before the window closes, because Avaloi stores only a hash and cannot show the token again.
  3. The bootstrap command runs on your server and enrolls it.

A token works one time and expires after 15 minutes.

If your company has no plan yet, Avaloi explains that provisioning starts after you add a plan, and it points you to test sites.

What staff do

Starting a node through a provider, draining a node so no new sites land on it, and deleting an empty node are actions for Avaloi staff. Deleting a node through the API needs confirm: true. If you need one of these, contact support.

Limits

  • Avaloi keeps 20 percent of every node free.
  • An enrollment token works once and expires after 15 minutes.

Quick answers

Why is my Nodes list empty? No paid site has started a server yet. Test sites run on the simulated node.

Can I create an enrollment token myself? Not today. Avaloi staff create them. Ask support.

What does the last heartbeat mean? The last time the agent on the node reported in to Avaloi.

API

Routes you can call:

  • GET /v1/nodes
  • GET /v1/nodes/{id}
  • GET /v1/nodes/{id}/capacity

Routes for Avaloi staff:

  • POST /v1/nodes
  • POST /v1/nodes/{id}/drain
  • DELETE /v1/nodes/{id}
  • POST /v1/nodes/enrollment-tokens

Still stuck?

Email [email protected] with your site name and what you tried, or send us a message.