DocumentaciónHelp

Install an agent

Create an agent from the web and run the command shown on screen on the server, on Linux or Windows.

On this page

Create the agent in ARGUNIS and then install it on the server with the command and key shown on screen.

Before you begin

  • You need the administrator role.

  • Your plan must have agent quota available.

  • Access to the server:

    • Linux: as root. For the systemd installation, the server needs Node.js 22 or later; you can also install it with Docker.

    • Windows: PowerShell as Administrator, on Windows Server 2016 or later, or Windows 10/11.

Step 1: create the agent

  1. Go to Settings → Monitoring → Agents.

  2. Click New agent.

  3. In Server where you will install it, choose the server if you already monitor it, or Another server (not monitored yet). The agent is placed in the same inventory group and the same category as the chosen server.

    • If you reinstall the agent on a server that already had one, the list also shows its inactive servers with "Inactive: continue this server". Choose that one: the new agent continues that server's history instead of creating a new one.

  4. Optional: enter the Agent name. If you leave it empty, it is named after the server followed by -agent. It accepts 2 to 40 letters, numbers, spaces, periods, hyphens, and underscores.

  5. Click Create agent.

A window opens with the agent name and the installation instructions.

Copy the command and the key right away: the key is shown only once, works for a single host, and expires on the date shown in the window. If you lose it, generate another one with New key.

Step 2: install on Linux

  1. In the window, choose the Linux tab.

  2. In Step 1 · install, use Copy to copy the command for your installation type. If there is more than one ARGUNIS server to connect to, you'll see a pair of commands for each one:

    • systemd (Node.js 22+), for a regular Linux server.

    • Docker, if you prefer to run it as a container.

  3. Paste the command on the server and run it as root.

  4. In Step 2 · paste the key when the installer asks for it, copy the Installation key (single use) and paste it when the installer asks for it. Nothing appears on screen when you paste it: this is normal. Press Enter.

In some cases the window shows a different order: first Step 1 · save the key, with a command to save it in a protected file (you run the command, paste the key, press Enter, and then Ctrl+D), and then Step 2 · install. Follow the steps as they appear.

Step 2: install on Windows

  1. In the window, choose the Windows tab.

  2. Open PowerShell as Administrator on the server.

  3. Copy the Windows (PowerShell) command and paste it. It is a single line.

  4. When the installer asks for it, paste the Installation key (single use). It isn't shown when you paste it. Press Enter.

If the Windows tab says the Windows installer hasn't been published yet, ask Argunis for help before installing.

Verify the installer

Before running it, you can check that the installer is the original. The Verification section shows the Installer URL and its SHA-256 fingerprint (on Windows, that of the Windows installer). At the end is the Server public key. With Copy all you copy all the instructions together.

What happens next

  • When the agent connects, the Agents list shows its status, version, installation type, and last report.

  • The server appears in Infrastructure → Servers with its metrics. See Data the agent provides.

Related

Search Argunis Monitoring

Type at least 2 characters to search Argunis Monitoring.

↑↓ to navigate · Enter to open · Esc to close