Preparing USB Installation Drives

To install a VotingWorks application on hardware, we have created a simple install tool: vx-iso.

There are two USB drives involved in the installation process:

  • Vx-iso - an Arch Linux iso installer program. This USB has been provided to you.

  • Vx-data - An empty USB drive to which you will copy a previously created VotingWorks application image. This USB is also provided.

To create a functional Vx-data USB drive, on the host build machine, you need to attach the USB you will be using. Be aware, any existing contents of the USB will be erased. You will also need to know the full path to the VotingWorks application image you want to install. Using the vxadmin image referenced in the Trusted Build process, the path to that image will be:

/root/vxadmin-signed.img.lz4

Once you know the full path to the image file, run the following steps as the previously created “vx” user:

cd ~/code
git clone 
https://github.com/votingworks/vx-iso
cd vx-iso
./scripts/copy-image.sh /root/vxadmin-signed.img.lz4

You will be prompted to select the USB device by typing the device name, e.g. “sda". Once selected, the image will be automatically copied to the USB. It can safely be removed once the process completes. Proceed to "Installing a VotingWorks Image" instructions.

Last updated