> For the complete documentation index, see [llms.txt](https://frc-radio.vivid-hosting.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://frc-radio.vivid-hosting.net/advanced-topics/offseason-kiosk-programmer.md).

# Offseason Kiosk Programmer

### Releases

{% embed url="<https://vividhosting.box.com/v/frc-radio-kiosk>" %}

### Installation (Preferred)

1. Ensure that Docker Desktop is installed and running
2. Download and extract the "offseason\_installer\_vX\_Y\_Z.zip"
3. Right click and run the executable as admin

   <figure><img src="/files/PPQUyk7TkJ4yJROndSjP" alt=""><figcaption></figcaption></figure>
4. Select your desired network adapter to enable DHCP coexistance with a static IP. <mark style="background-color:red;">**Note**</mark><mark style="background-color:red;">: Ensure that the desired ethernet port is plugged in/active</mark>

   <figure><img src="/files/qDiAzLgBsJS99HCRNIGE" alt=""><figcaption></figcaption></figure>
5. Click Configure

   <figure><img src="/files/wuPfQrr5xZNIBehzwQ8p" alt=""><figcaption></figcaption></figure>
6. Wait for the kiosk to be installed

   <figure><img src="/files/HJSfE2F4lna08jicWWJJ" alt=""><figcaption></figcaption></figure>
7. Perform a self-test of the kiosk

   <figure><img src="/files/m2QAmU3oDH4kq7GjS7M1" alt=""><figcaption></figcaption></figure>
8. View the status of the health of the kiosk

   <figure><img src="/files/YpYfsB6uoiGPsNfXu7lp" alt=""><figcaption></figcaption></figure>
9. Open the kiosk in your default web browser

   <figure><img src="/files/s0bIABJ3u7YdPnbW9wO3" alt=""><figcaption></figcaption></figure>
10. Kiosk is ready for key material and event setup

    <figure><img src="/files/VRFOyelUVyhuCOuJcgbD" alt=""><figcaption></figcaption></figure>

### Alternate Installation

<details>

<summary>Installation (Manual)</summary>

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

1. 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
2. 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.&#x20;
3. 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}`)
```

4. 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.
5. 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
```

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

</details>

### Localization

The Kiosk Tool has localizations to support three languages:

* English (en)
* French (fr)
* Turkish (tr)

Here is how to change the localization on the Kiosk Tool:

{% stepper %}
{% step %}

### Go To The Admin Page

```
http://localhost/admin
```

<figure><img src="/files/hIbVF7uTWLlFyflA6XIJ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Enter The Admin Password

Changes will be disabled until you enter the admin password for the Kiosk tool:

<figure><img src="/files/BzbYKQRiUJuaa67QQIXR" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select The Desired Language

<figure><img src="/files/kvYisL8Ayvowt2uoVw7z" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click Save

The Kiosk Tool will now display in the selected language.

<figure><img src="/files/Ue15RYUiibonaKvQsfyt" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}