Skip to content

Claim your device manually

This section describes how to manually claim your device, which could prove useful for devices that don't have Avahi discoverability features, like in the case of our Malta QEMU example device. If you need to know how to do it automatically, go to our claim your device automatically guide.

The first thing to do in order to interact with your Malta QEMU example is to claim the device. By claiming the device it's identifier becomes uniquely associated with your user account, and all the objects and relevant trail information become private under your namespace. In this case we need the challenge and the device-id of the temporary device so that it can be claimed by the just-registered user account. In the LEDE console:

# cat /pantavisor/challenge
pleasantly-finer-unicorn
# cat /pantavisor/device-id
5b582638c67920b9de2

We can then use the PVR tool to claim with the user account. Please note that the last argument is the device endpoint, in full URL form, to the Pantahub host where this device exists.

IMPORTANT: Remember to use the device-id and challenge from above, not the example, in all PVR commands.

$ pvr claim -c CHALLENGE https://api.pantahub.com/devices/DEVICE-ID
*** Login (/type [R] to register) @ https://api.pantahub.com/auth (realm=pantahub services) ***
Username: youruser
Password: ********

You can also claim your device directly from the web interface of PantaHub.com. Once it has been claimed and the device has realized this, it will show up in your devices list.

If everything goes well this means your device has been claimed by the user account. You can now use PVR to clone your device, work on it's state and push a new revision.