A Pre-Built Raspberry Pi image is available for ease of installation.
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.
Note
Make sure you download the image that ends in '-RasberryPi.xz'.
An 8GB or larger card is recommended.
Use the 1.18.11 version of 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.
Warning
Using a version of Balena Etcher older than 1.18.11 may cause bootlooping (the system will repeatedly boot and restart) when imaging your Raspberry Pi. Updating to 1.18.11 will fix this issue.
If you are using a non-standard Pi Camera connected to the CSI port, :ref:`additional configuration may be required. <docs/hardware/picamconfig:Pi Camera Configuration>`
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.
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 :ref:`static IP in PhotonVision. <docs/settings:Networking>`
To upgrade a Raspberry Pi device with PhotonVision already installed, follow the :ref:`Raspberry Pi update instructions<docs/installation/updating:offline update>`.