Raspberry Pi Installation

A Pre-Built Raspberry Pi image is available for ease of installation.

Downloading the Pi Image

Download the latest release of the PhotonVision Raspberry image (.xz file) from the releases page. You do not need to extract the downloaded ZIP file.


Make sure you download the image that ends in ‘-RasberryPi.xz’.

Flashing the Pi Image

An 8GB or larger card is recommended.

Use Balena Etcher to flash an image onto a Raspberry Pi. Select the downloaded .tar.xz file, select your microSD card, and flash.

For more detailed instructions on using Etcher, please see the Etcher website.


Using an older version of Balena Etcher may cause bootlooping (the system will repeatedly boot and restart) when imaging your Raspberry Pi. Updating to the latest Balena Etcher will fix this issue.

If you are using a non-standard Pi Camera connected to the CSI port, additional configuration may be required.

Final Steps

Insert the flashed microSD card into your Raspberry Pi and boot it up. The first boot may take a few minutes as the Pi expands the filesystem. Be sure not to unplug during this process.

After the initial setup process, your Raspberry Pi should be configured for PhotonVision. You can verify this by making sure your Raspberry Pi and computer are connected to the same network and navigating to http://photonvision.local:5800 in your browser on your computer.

Troubleshooting/Setting a Static IP

A static IP address may be used as an alternative to the mDNS photonvision.local address.

Download and run Angry IP Scanner to find PhotonVision/your coprocessor on your network.


Once you find it, set the IP to a desired static IP in PhotonVision.

Updating PhotonVision

To upgrade a Raspberry Pi device with PhotonVision already installed, follow the Raspberry Pi update instructions.