Skip to content

First Boot

If you have already downloaded a Pantavisor image, it is time to use it for the fist time in your device. For that we are generally going to flash the storage medium of the device and set up its connectivity so you can manage it from your host computer. If you want to perform this management using Pantacor Hub, you will need to connect it to an Internet-facing network.

Target Device Architectures


These guides do not cover all the boards we support. The more complete list of boards currently supported can be consulted here.

RPi3, RPi4, BPi-R2, BPI-R64 or RPi0

To use these images, you need to flash your SD card and then boot the board up. You can see how to do this with more detail in the get started guide, which focuses RPi3 and RPi4, but the process will be similar for all of these devices.

To connect the board to a LAN or directly to your computer, you can follow the RPi3 and RPi4 instructions again.


These images boot from an external storage device (SD card, USB key..) from BIOS/UEFI. The default image is meant to be directly flashed onto the final storage device where the system will run, while the installer is flashed into a temporary storage device. To see how to flash your storage device, take a look at the get started guide. Even though this guide is for RPi3 and RPi4, the flashing process will be similar.

Once this is done, insert the storage device into your x64 device and power it up. You might also need to access the BIOS/UEFI menu and boot the target device from the storage device, if that is not the default boot option. In that case, you will need to do this with a keyboard and screen connected to your device.

To connect the board to a LAN or directly to your computer, you can follow the RPi3 and RPi4 instructions again.


If you are using the default image, Pantavisor boots from the storage device. Just make sure your BIOS/UEFI is set to run that device by default and you should be good to go.


After booting up, the installer prompts with a menu and automatically flashes the first available permanent storage device found. A reboot is required after this finishes.

For troubleshooting or to simply choose the permanent storage device from a list of flashable devices, select the manual installation option in the menu before it triggers the automatic installation. Instructions will follow on screen that describe how to do this from the console.


Despite Pantavisor is made to be run on embedded devices, you can also try it out by emulating the device with QEMU. Another option that we cover in a different guide is to run Pantavisor as a deamon in any Linux system.


Before you can use the image, change its format to QCOW2 using the qemu-img tool. Remember to use the default (non-installer) x64 image:

qemu-img convert -O qcow2 x64_initial_stable.img x64-uefi-pv-4096MiB.qcow2

Besides that, it is necessary to run an OVMF. Once done, execute this command:

qemu-system-x86_64 -enable-kvm \
    -bios /usr/share/qemu/OVMF.fd \
    -drive file=x64-uefi-pv-4096MiB.qcow2,format=qcow2 \
    -nographic \
    -m 512m \
    -net nic \
    -net user

This should run the image and show a menu to finally execute Pantavisor.


We prepared a Docker container that allows you to run the malta-qemu image. Keep in mind though that the script that runs changes the network configuration on your host:

docker run --privileged --net host -v </your/host/path/to/pflash.img>:/tmp/pflash.img -it --rm pantacor/qemu-malta-16m

When the initialization script and boot up log ends, press ENTER to see the LEDE console.


Our pre-compiled images are built with the PANTAVISOR_DEBUG option. This means you will have SSH, TTY and other goodies available for debugging your devices. Most of the items explained in our getting started troubleshooting section are applicable here.