Download and Flash Image

Getting Started with Pantavisor Linux

This guide will walk you through setting up Pantavisor Linux on a Raspberry Pi 3B. While Pantavisor supports a variety of embedded devices, the steps here are tailored for the Raspberry Pi 3B. If you are looking to apply the same principals here applied got to

Prerequisites

Before you begin, make sure you have the following ready:

  • Internet connection: Required to download the necessary files.
  • Laptop or desktop computer: You’ll use this to download the Pantavisor image and flash it onto the microSD card.
  • MicroSD card: A card with at least 8GB of storage is recommended.
  • Compatible embedded device: This guide focuses on the Raspberry Pi 3B.
  • SD card reader: To connect the microSD card to your computer.
  • USB to TTY serial converter: This is a crucial tool for debugging your device. It allows you to connect to the device’s serial console and see boot logs, error messages, and system output directly on your computer.

Download the Pantavisor Linux Image

The first step is to get the Pantavisor image for your specific device.

  1. Head over to our Downloads page to see all available platforms and images.
  2. Find the image that matches your device—in this case, select the image for the Raspberry Pi 3B. Download the latest stable version.
  3. The downloaded file will be a compressed image, typically named pantavisor-starter-raspberrypi-armv8.rootfs.wic.bz2.

Compatibility Check: To avoid issues, always verify that your device is officially supported by Pantavisor Linux before you download and flash the image. You can find a complete list of supported platforms on our supported hardware page.

Flash the Image to Your MicroSD Card

Now that you have the Pantavisor image, the next step is to write it to your microSD card. We will use the bmaptool for this, which is a highly efficient tool for flashing images. This method is faster than traditional tools like dd because it only writes the data blocks that have changed.

Using bmaptool

  1. First, you need to install bmaptool on your system.

    • On Debian/Ubuntu: sudo apt-get install bmap-tools
    • On Fedora/CentOS: sudo dnf install bmap-tools

  2. Once installed, you can use the bmaptool to flash the image to your microSD card. Be extremely careful with this step, as entering the wrong device name can overwrite your computer’s hard drive.

    # Flash to SD card (replace /dev/sdX with your SD card's device name)
sudo bmaptool copy pantavisor-remix-raspberrypi-armv8.rootfs.wic.bz2 /dev/sdX

Finding Your SD Card’s Device Name:

  • Linux: Use lsblk or fdisk -l to list all storage devices.
  • macOS: Use diskutil list to see a list of connected disks.

Boot Up Your Device

With the image successfully flashed, you are ready to boot your Raspberry Pi for the first time.

  1. Insert the microSD card into the slot on your Raspberry Pi.
  2. Connect USB to TTY serial converter to Raspberry Pi default console TX/RX.
  3. Connect your device to a network. An ethernet cable is highly recommended for the first boot to ensure a stable connection.
  4. Plug in the power supply to turn on the device.
  5. Next Go the section Device Access for further instructions!