Add server

Reading Time: < 1 minute

When to use

The page describes the startup script of the addition new server to an existing Vezha cluster through a one-time OTP.

What to prepare

  • Access to the desired cluster in Vezha.
  • Access the target server with administrative rights.
  • The selected license for the server (if you need advanced capabilities immediately after connecting).

Steps in the UI

  1. Open the cluster and run Add Server.
  2. Generate OTP.
  3. Copy the value: CLUSTER_ID, OTP, endpoint, ingress-endpoint.

Steps on the server

  1. Download the agent for your OS.
  2. Run the join command with parameters from the UI: Join by OTP.
  3. Install the agent as a service: sudo ./vezha-agent install.

Importantly

  • OTP has a short TTL (10 minutes in the current implementation), so don’t delay the command.
  • If the server is reinstalled, use reconnect instead of rejoining the new node: Reconnect the server.

What to check after adding

  • The server is displayed in the cluster list.
  • Live metrics are coming.
  • The actions in the server card correspond to the assigned license.
Scroll to Top