Installing the agent

Reading Time: < 1 minute

What you will get after installation

The Vezha agent transmits telemetry in real time, supports managed actions (terminal, VNC, Docker Exec, service management) and works over a secure gRPC circuit.

Supported platforms

  • Linux (vezha-agent-linux-musl-x86_64)
  • macOS Intel (vezha-agent-macos-x86_64)
  • macOS Apple Silicon (vezha-agent-macos-aarch64)
  • Windows x86_64 (vezha-agent-windows-x86_64.exe)

Prerequisites

  • A cluster has been created in Vezha.
  • OTP for adding a server (see OTP generation for new server).
  • Access to the server with administrator rights (sudo or Administrator).

Basic sequence

  1. Download the agent binary for your OS.
  2. For Linux/macOS, grant execute rights: chmod +x ./vezha-agent.
  3. Execute join (exact instructions: Join by OTP).
  4. Install the agent as a service:
sudo ./vezha-agent install

Mode without service (optional)

For manual startup or diagnostics, use:

./vezha-agent run

What to check

  • The server appeared in the cluster in the status online.
  • CPU/RAM/IO/Network metrics are visible in Live View.
  • History and managed license actions are available in the server card.
Scroll to Top