Skip to main content

Install the Beagle Agent

When you’ve registered your device with Beagle Control, you’re ready to install the agent.


The Beagle Agent is a small daemon that runs in the background of Linux devices and checks in to Beagle Control to report its health and status metrics (such as CPU usage, disk space, etc.) and to see if it needs to do anything (install Linux package updates remotely, reboot etc.)

You can read more about the agent, its system requirements, version history and more in the dedicated Beagle Agent section.

Get the install command

If your device has never communicated with NodeBeagle, when you access the device's page (the page shown immediately after adding your device, or by clicking your device's name from the dashboard, or from the Devices > All Devices menu) NodeBeagle will provide you with the command needed to install the latest version of the agent.


Select the operating system and architecture for the device to generate the relevant instructions.

For a Linux agent, click the Copy to clipboard link for either the curl or wget command, depending on what is available on your device's Linux distribution.

You do not need to use both commands. If you are not sure which to use, try the first command (curl) and if that doesn't work, try the second (wget.)

With the command copied to your clipboard, connect to your device.

  • For servers, this will typically be over SSH or the server's text-based console.
  • For desktops, or devices with a GUI, open the Terminal application.

Paste the command into your terminal and press ENTER to run the command.

Check the output

root@localhost:~# curl -s***** | sudo bash
Running as root, proceeding with installation
Checking existence of installation directory '/usr/local/nodebeagle-agent/bin'...
Downloading agent v1.0.0-beta.3 from using curl...
Checking we can execute the agent
2021/11/12 14:37:04 Running 'version' command
NodeBeagle agent 1.0.0-beta.3
Built for linux amd64 using Go go1.17.2
Checking for systemd or sysvinit
Using systemd init system
Registering your server with Beagle Control
2021/11/12 14:37:04 Creating runtime directory /usr/local/nodebeagle-agent/var
2021/11/12 14:37:04 Initialising log file at /usr/local/nodebeagle-agent/var/agent_2021-11-12.log
2021/11/12 14:37:04 Agent version 1.0.0-beta.3 initialised with arguments: [register NB-S-*****]
2021/11/12 14:37:04 Running 'register' command
2021/11/12 14:37:04 Activating this device with agent key: NB-S-*****
2021/11/12 14:37:04 Calling API URL
2021/11/12 14:37:04 {"token":"*****" ..... "display_name":"NodeBeagle Demo"}}}}
2021/11/12 14:37:04 Device registered successfully
Starting the nodebeagle-agent service
Created symlink /etc/systemd/system/ → /etc/systemd/system/nodebeagle-agent.service.

After installation, you should see a line that reads "Device registered successfully".

Check the data

After a few minutes when the device has begun reporting, the device's installation page will refresh and display the graphs.


Continue to the next page by clicking the Next link below to find out how to review the data received from your device.