Register Device (Agent 6.x & lower)
This procedure is applicable for registering a device with Connect Agent version 6.x or lower.
Last updated
Was this helpful?
This procedure is applicable for registering a device with Connect Agent version 6.x or lower.
Last updated
Was this helpful?
There are a few ways to register a device in the JFrog Connect system. This page describes how to connect a single Linux-based device using the wget command on your device.
If you already have Connect Agent 7.0, use the procedure in .
If you have not updated to Connect Agent 7.0 and would like to, use the procedure in . Then you can register the device using the procedure for Agent 7.0.
You need the following before starting the procedure:
Device meets minimum hardware, OS, and software requirements as described in
Internet connectivity with the device
JFrog Connect account created and a project defined as described in
Complete the following steps:
In the Connect web UI, click Register a Device on the top left.
A popup opens showing a command that includes your user token and the project name in the places indicated below.
Open the command line terminal on your device and run the command that appears in the Device Registration popup. In most cases, you will need to copy the command into the device or type in the command manually. The tabs in the Device Registration popup show different forms of the command to use depending on whether you are a root user or a regular user.
When the command completes successfully, the device will appear as “New Device” in the Devices page as shown below.
You can add optional parameters to the end of the Register command.
-n=<device_name> Sets a device name when the device is registered. You can enter a fixed name (e.g., -n=BlueDevice014) or you can use a parameter like “$HOSTNAME”.
-g=<group_name> Assigns the device to a specific group when the device is registered. The group must already exist in the system.
-s=<software_version> Creates an application called default_app with the version that you enter in the command.
Example Command
If you do not set the device name and group name parameters when registering the device (using the optional registration parameters), you can always rename the device later and assign it to a different group using the web UI.
In the Devices page, select the row of the device you want to modify.
In the General Details panel on the Devices page, click Change. Then you can edit the device name, reassign the device to a different group, and save your changes.
After you enter the registration command, you may need to wait several seconds until the new device appears on the Devices page. If the device does not appear, try the steps below.
Check the network connection of your device.
Ensure that systemd or SysV is installed.
If you are using SysV, ensure that the systemd directory doesn't exist: /etc/systemd/system.
Ensure that the user_token and project_name are correct.
Run the installation command as a root user.
See the page for common issues and fixes.
It is also possible to register devices without a direct download to the device. Additional methods enable device registration at scale. .
