🎡Offseason Kiosk Programmer

In the event that you're hosting an offseason event, a Docker image containing the radio programming utility can be found below.

Releases

https://vividhosting.box.com/v/frc-radio-kioskvividhosting.box.com

Installation (Preferred)

Ensure that Docker Desktop is installed and running
Download and extract the "offseason_installer_vX_Y_Z.zip"
Right click and run the executable as admin
Select your desired network adapter to enable DHCP coexistance with a static IP. Note: Ensure that the desired ethernet port is plugged in/active
Click Configure
Wait for the kiosk to be installed
Perform a self-test of the kiosk
View the status of the health of the kiosk
Open the kiosk in your default web browser
Kiosk is ready for key material and event setup

Alternate Installation

Installation (Manual)

The only requirements are that Docker is installed and a network interface (Ethernet adapter) is configured to 192.168.69.2/24

Assign the IP address of 192.168.69.2 with a netmask of 255.255.255.0 and no default gateway to your ethernet adapter of choice
From a terminal open to the folder containing vh109-kiosk-0_2_0.tar.gz, run docker image load --input vh109-kiosk-0_2_0.tar.gz. This loads the docker image from the archive.
If you don't need to change the default password ("supercoolpassword"), skip to step 4. The password is set using a hash and salt. As a hacky solution, the salt and hash can be generated by running the following in node (or any online NodeJS compiler).

const crypto = require("crypto")
const pass = "<SET PASSWORD HERE>"
const salt = crypto.randomBytes(8).toString("base64")
const hash = crypto.createHash("sha256").update(pass + salt).digest("base64")
console.log(`salt: ${salt}\nhash: ${hash}`)

To persist the team keys data, we need to mount a local folder to the docker container. Create a data folder in the desired location. It must be referenced by absolute path and have the desired security for the raw team keys csv data.
Run the docker container with the following, replacing "/path/to/local/folder" with the path to the folder you just created.

docker run -d --name kiosk --restart always -p 80:80 --net=bridge -v "/path/to/local/folder:/app/data" vh109-kiosk

If you created a custom password, use this command and also replace <HASH> and <SALT> with what you generated.

docker run -d --name kiosk --restart always -p 80:80 --net=bridge -v "/path/to/local/folder:/app/data" -e OVERRIDE_KEY_UPLOAD_HASH="<HASH>" -e OVERRIDE_KEY_UPLOAD_SALT="<SAlT>" vh109-kiosk

If you get an error about a container with the name kiosk already being in use, run the following to remove it.

docker stop kiosk
docker rm kiosk

At this point, the kiosk should be running at http://localhost and auto restart as long as docker auto restarts.
Upload your key material in CSV format (team,key) at http://localhost/upload
The kiosk is now ready for use!