Register Device

This procedure is applicable for registering a device that has Connect Agent version 7.0 or higher. Whenever you register a device to JFrog Connect, the latest Connect Agent version will be downloaded to the device.

Prerequisites

You need the following before starting the procedure:

• Device meets minimum hardware, OS, and software requirements as described in Connect Agent.

• Internet connectivity with the device.

• JFrog Connect account created and a project defined as described in Create JFrog Connect Account.

Connect a Device

To register a device, complete the following steps:

1. The Project-Device pairing token will be linked to the project that is in the main filter. In the Connect web UI, go to the project filter and choose the project to which the device will be paired.

1. In the Connect web UI, click Register Device on the top right.

2. In the Device Registration popup, choose whether the wget command should run as a root or non-root user on your device.

1. Generate the project-device pairing token.

2. (Optional) Enter values for the optional parameters. If you do not enter the values now, you can enter them later in the Devices page of the web UI.

1. Review the command generated at the bottom and copy it to your clipboard.

2. Open the command line terminal on your device, paste the command from your clipboard, and run it.

Optional Parameters

In Step 4 above, you can enter values for the optional parameters listed below. If you do not set them in the registration command, you can set them in the Devices page of the UI after the registration has been completed.

• Device Name: Sets a device name when the device is registered. If you don’t enter a device name, the device will be given the default name New Device followed by a number, for example, New Device 14.

• Group: Assigns the device to a specific group at registration time. The group must exist already.

• Application Name: The Connect Agent will be called the name that you enter.

• Application Version: If you entered an application name, you must also enter a version.

Troubleshooting

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 systemd or SysV is installed.

3. If you are using SysV, ensure that the systemd directory does not exist: /etc/systemd/system.

4. Run the installation command as a root user.

5. See the Troubleshooting page for common issues and fixes.

What’s Next?

Learn about methods of device registration at scale.