Join by OTP

Reading Time: < 1 minute

When to use

Scenario Join by OTP used to connect new server to the existing Vezha cluster.

What to prepare in the UI

  • CLUSTER_ID of the desired cluster.
  • Disposable OTP to add a server.
  • endpoint and ingress-endpoint (usually the same).

Join command

./vezha-agent join --cluster-id <CLUSTER_ID> --otp <OTP> --endpoint https://grpc.app.vezha.io --ingress-endpoint https://grpc.app.vezha.io

What does join do

  1. Registers the server in the selected cluster via OTP.
  2. Gets a bootstrap token and issues a client certificate.
  3. Saves the agent configuration for later launch.

After join

Install the agent as a service:

sudo ./vezha-agent install

If manual start (without service) is required, use:

./vezha-agent run

Important checks

  • The OTP has a limited validity period (10 minutes in the current implementation), so execute the command immediately after generation.
  • For an existing server after reinstallation/migration, use reconnect instead of join: Reconnect the server.
  • After connecting, check the server in the cluster and the appearance of live metrics.
Scroll to Top