.png%3Falt%3Dmedia%26token%3D01c36d88-f1dc-4330-ac87-1d8503ed4395){kind=icon}
.png%3Falt%3Dmedia%26token%3D01c36d88-f1dc-4330-ac87-1d8503ed4395){kind=icon}
Register a Device
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.
You need the following before starting the procedure:
- Internet connectivity with the device
Complete the following steps:
- 1.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.
sudo wget -O - "https://connect.jfrog.io/v2/install_connect" | sudo sh -s <UserToken> <Project>
- 2.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
su -c 'wget -O - "https://connect.jfrog.io/v2/install_connect" | sh -s 81CGQw6GjFsAehZ6mkKpwWGfAkJXdecggR Demo -n=my_device_name -g=Test -s=1.0'
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.
- 1.In the Devices page, select the row of the device you want to modify.
- 2.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.
- 1.Check the network connection of your device.
- 2.Ensure that
systemdorSysVis installed. - 3.If you are using
SysV, ensure that thesystemddirectory doesn't exist:/etc/systemd/system. - 4.Ensure that the
user_tokenandproject_nameare correct. - 5.Run the installation command as a root user.
- 6.
It is also possible to register devices without a direct download to the device. Additional methods enable device registration at scale. Learn more.