Register Device

Connect a single device using the wget command on your 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 fleet defined as described in Create JFrog Connect Account.

Connect a Device

Tip: All input parameters in Connect, such as fleet name, group, device, access tokens, etc., are case sensitive.

To register a device, complete the following steps:

1. In the Connect web UI, go to the fleet filter and choose the fleet to which the device will be paired.

1. In the Connect web UI, go to the Devices page and 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 pairing token.

2. Enter the name of the Group in the fleet. This assigns the device to a specific group at registration time. The group must exist already.

3. (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. Click Copy Command.

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

Optional Parameters

In Step 6 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.

• Deployment Tag: Puts a tag on the agent deployment.

• Deployment Tag Version: If you entered a deployment tag, 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.

What’s Next?

Learn about methods of device registration at scale.