• Release: 004
  • Tag: 004
  • Date: May 28, 2018
  • Summary: Feature and bugfix update for pvr

Get started

Simply (g)unzip and put pvr into a directory in PATH and off you go.

Download PVR

Known Issues:

  • None

Build PVR

See the in top of pvr source project for more info...

Register Account

To get started register with pantahub:

$ pvr register --user="yournick" --pass="yourpass" --email="[email protected]"
2017/06/19 11:08:43 Registration Response: {
  "id": "5947949b85188a000c143c2e",
  "type": "USER",
  "email": "[email protected]",
  "nick": "youruser",
  "prn": "prn:::accounts:/5947949b85188a000c143c2e",
  "password": "yourpassword",
  "time-created": "2017-06-19T09:08:43.767224118Z",
  "time-modified": "2017-06-19T09:08:43.767224118Z"

User 'youruser' registered. Follow email instructions sent to '[email protected]' before you can log in.

Clone an example repo:

In this example we clone our example rpi3 alpine based system. You can use username: examples and password: examples to retrieve this:

pvr clone rpi3-alpine-mini

$ ls
0base.cpio.xz  alpine-mini.json  alpine-mini.squashfs  firmware.squashfs  kernel.img  lxc-alpine.config  modules.squashfs  pantavisor.json

Scan for pantavisor devices on local network

Since 004 release pvr scan supports finding devices that announce themselves on mdns for easy discovery and claiming.

$ pvr scan
Scanning ...
        ID: 5b0cf52979b74d0009a7175e (unclaimed)
        Host: linux.local.
        IPv4: []
        IPv6: [2a02:2028:708:3d01:602:a2ff:feb3:d4e8]
        Port: 22
        Claim Cmd: pvr claim -c brightly-immense-bat

        ID: 5b0aa4363c6f7200095b2566 (owned)
        Host: linux.local.
        IPv4: []
        IPv6: [2a02:2028:733:ee01:602:a2ff:feb3:d4e8]
        Port: 22
        Pantahub WWW:
        PVR Clone:

Claiming: How to become owner of a device discovered through pvr scan

For an unclaimed device you simply would copy paste the "Claim Cmd:" in the output above to make that device owned by you:

$ pvr claim -c brightly-immense-bat
# no output expected means: success

Devices you are owner from will initially sync their state with your account storage etc. and once done will show up on your device list in pantahub and you will have permissions to roll updates, change configuration or delete it.

Claiming: devices that do not have mdns support might have telnet support enabled

  1. Flash your Pantavisor device (see PV release)
  2. Boot up, telnet into your device and tail -f /tmp/pantavisor.log -> there you will see both device id as well as challenge getting logged
  3. Claim device with pvr: ``` $ pvr claim -c YOURCHALLENGECHALLENGE *** Login (/type [R] to register) @ (realm=pantahub services) *** Username: ...

# Deploy a the "example repo" from above to your device:

$ cd myrepo $ pvr post ...