Skip to main content

Register your first Linux device

To manage your Linux devices in the cloud-based console (known as Beagle Control) you need to register it.


NodeBeagle requires a small piece of software running on your device (the Beagle Agent) that communicates back to Beagle Control.

There are 2 ways to do register your device:

  1. Registering your device in Beagle Control - then installing the agent using your device’s unique key 
  2. Installing the agent on your device - then registering it with Beagle Control from your device’s command line using your account’s discovery key.

The second way is called “Device discovery” and is great for unattended, or non-interactive setups - such as containerised builds.

Device discovery is covered in another chapter. This guide focuses on the first way.

Add your device

You add your devices to NodeBeagle using the Add a device screen. Click the Devices menu, followed by Add a device.


Enter a name to refer to this device within NodeBeagle. This does not have to be your machine's fully-qualified hostname (FQDN) - this is reported separately by the agent.

Select the data-centre region closest to your device.

Currently, there is only one data-centre region (Gloucester, UK.) We plan to expand this in the future to include data-centre regions in different countries.

Select the billing interval (monthly or hourly) and service level (Standard or Pro) you want this device to use.

Some billing interval and service levels may not be available to you. The available options depend on what you have enabled on your subscription.

If you have already configured device groups, you can choose which groups to add the new device to.

Click the Create button to add your new device.


Your device has now been added to the NodeBeagle platform. To communicate with your device, NodeBeagle requires an agent to be installed - a small piece of software that runs in the background.

NodeBeagle will provide installation instructions to install the agent on your device.

Continue to the next page by clicking the Next link below to find out how to install the NodeBeagle Linux agent on your Linux device.