Register a device

The first step in reaching your edge from anywhere.

Connecting Linux device

After creating a project, at the top of the dashboard, press on Register Device
A window will pop up with instructions on how to register a Linux device. Basically, all you need to do is run the shown command on the device's terminal.
Please note that you must replace the <USER_TOKEN> with your private user token and <PROJECT_NAME> with your project name.

Optional Parameters

  1. 1.
    Device Name - to enter a device name at registration, add the flag -n=<DEVICE_NAME> at the end of the registration command (for example, you can use "$HOSTNAME" as your device name).
  2. 2.
    Device Group - to make the device register to a specific group, add the flag -g=<GROUP_NAME>at the end of the registration command (the group must exist).
  3. 3.
    Device Software version - when defined, it will create an application called "default_app" with the specified version at registration. Add the flag -s=<SOFTWARE_VERSION> at the end of the registration command.
su -c 'wget -O - "<URL>" | sh -s <USER_TOKEN> <PROJECT_NAME> -n=<DEVICE_NAME> -g=<GROUP_NAME> -s=<SOFTWARE_VERSION>'
After a few seconds, your device should appear in the Devices category on the Dashboard.
If you don't see your device in the dashboard:
  1. 1.
    Check the network connection of your device.
  2. 2.
    Make sure systemd or SysV is installed.
  3. 3.
    If you are using SysV, make sure the systemd directory doesn't exist: /etc/systemd/system.
  4. 4.
    Make sure the user_tokenand project_name are correct.
  5. 5.
    Make sure You run the installation command as a root user.
  6. 6.
    Check the Troubleshooting section for common issues and fixes.

Registering a device without wget

The device registration algorithm can also be initiated without a direct download of JFrog Connect's agent.
You may embed the agent itself into the device image to have it automatically provisioned into your project, as instructed in the guide below: