Advanced Command Line Usage

PhotonVision exposes some command line options which may be useful for customizing execution on Debian-based installations.

Running a JAR File

Assuming java has been installed, and the appropriate environment variables have been set upon installation (a package manager like apt should automatically set these), you can use java -jar to run a JAR file. If you downloaded the latest stable JAR of PhotonVision from the GitHub releases page, you can run the following to start the program:

java -jar /path/to/photonvision/photonvision.jar

Updating a JAR File

When you need to update your JAR file, run the following:

wget -O
sudo chmod +x
sudo ./
sudo reboot now

Creating a systemd Service

You can also create a systemd service that will automatically run on startup. To do so, first navigate to /lib/systemd/system. Create a file called photonvision.service (or name it whatever you want) using touch photonvision.service. Then open this file in the editor of your choice and paste the following text:

Description=Service that runs PhotonVision

ExecStart=/usr/bin/java -jar /path/to/photonvision/photonvision.jar


Then copy the .service file to /etc/systemd/system/ using cp photonvision.service /etc/systemd/system/photonvision.service. Then modify the file to have 644 permissions using chmod 644 /etc/systemd/system/photonvision.service.

Installing the systemd Service

To install the service, simply run systemctl enable photonvision.service.


It is recommended to reload configurations by running systemctl daemon-reload.