Skip to content

Managing Nodes

The Nodes page is the Gateway's home screen. It shows all nodes that have been registered with the Gateway, their current status, and overall Gateway statistics.

Nodes home page showing a list of connected nodes on the left and the stats panel on the right

Node status

Each node in the list has a coloured status indicator:

Colour Meaning
Green Connected and healthy
Amber Connected but busy, starting up, or requests are queued
Red Activated but disconnected or experiencing errors
Grey Deactivated — not attempting to connect

Gateway stats

The right-hand panel shows live statistics for the Gateway:

  • Requests handled — Total inference requests processed since the Gateway last started
  • Delayed requests — Requests that took longer than the expected threshold to complete
  • Cluster max concurrency — A measure of how evenly multiple nodes are sharing load (shown when more than one node is connected)
  • Uptime — How long the Gateway has been running since its last start

Adding a node

Click the New Node button to connect a node to the Gateway.

This button is only visible to accounts with the Node Management permission. If you do not see it, ask an administrator.

New Node popup showing fields for Node Name, Node Address, and Node Port

Fill in the following:

  • Node Name — A display name for this node. A random name is suggested automatically; click the refresh icon to generate another.
  • Node Address — The IP address or hostname of the machine running the Node service.
  • Node Port — The port the Node listens on. The default is 8022 and should only be changed if you have configured the Node to use a different port.

Click Next. The Gateway will attempt to connect to the Node and verify the connection. If verification succeeds, click Next again, then Finish to save.

If verification fails, check that: - The Node service is running on the target machine. - The address and port are correct. - Network access between the Gateway machine and the Node machine is not blocked by a firewall. - The Node access key in the Gateway's Configuration matches the key configured on the Node.

First-time auto-connect: When no nodes are registered, the Gateway will automatically attempt to connect to a Node running on the same machine (localhost:8022). If a local Node is found, it is registered as "Local Node" without any manual steps required.

Viewing a node

Click the edit icon on any node to open its detail view. This shows a multi-panel layout with information and controls for that specific node.

Selected node detail view showing node info panel, monitoring panel, log panel, and executors panel

Node information

The top-left panel shows the node's connection details and hardware:

  • Name and Address
  • Activated status
  • Version — the OptimaNode software version
  • CPU, RAM, GPU, VRAM — reported by the node once connected

Monitoring

The monitoring panel displays live hardware metric graphs from the node — CPU usage, RAM, GPU utilisation, and VRAM consumption.

Log

The log panel shows the node's real-time log output. Use the Info, Warning, Error, and Debug buttons to filter by log level.

Executors

The executors panel lists all AI model executors discovered and managed by this node. See Managing Models for details.

Removing a node

Open the node's detail view and click Delete. You will be asked to confirm. Removing a node disconnects it from the Gateway and removes it from the node list. It does not uninstall the Node software or delete any model files.