LogoLogo
  • Software Independence
  • System Security Architecture Description
    • Access Control
    • Artifact Authentication
      • Hashing of Continuously Exported Cast Vote Records
      • Preserving Voter Privacy
    • System Integrity
    • Networking
    • Password and Credential Policies
    • Defense-in-Depth and Least Privilege
    • Cryptography
  • Procedural and Operational Security
  • Known Vulnerabilities
  • Trusted Build
    • Build Machine Configuration
      • Installing Debian 12 to VxBuild
    • Online Phase
    • Offline Phase
    • Final Configuration
      • Secure Boot Signing
    • Installing an Image via vx-iso
      • Preparing USB Installation Drives
      • Installing a VotingWorks Image
      • Machine Configuration Wizard and VxCertifier
      • Verifying an installed image
    • Hash/Checksum Verification
    • Virt Manager - Network Access & Troubleshooting
  • Reliably Detectable Marks
Powered by GitBook
On this page
Export as PDF
  1. Trusted Build
  2. Installing an Image via vx-iso

Preparing USB Installation Drives

PreviousInstalling an Image via vx-isoNextInstalling a VotingWorks Image

Last updated 1 year ago

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

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.

vx-iso