# Basic Configuration Wizard If this is the first time that a VotingWorks application has been installed to a machine, the machine will boot into a basic configuration wizard. If the machine has been previously configured with a certified VotingWorks application of the same type, this wizard will be skipped. The majority of the steps are self-explanatory, but "Step 1: Set Machine ID" and "Step 4: Create Machine Cert" require some extra clarification. ### Setting Machine ID It is important that the machine ID be unique for each machine. Many machines have a physical placard on them indicating the machine ID. That is the ID that should be used here. ### Creating Machine Cert On VxAdmin, you'll first see a prompt to enter a jurisdiction: {% code overflow="wrap" %} ``` Enter a jurisdiction ({state-2-letter-abbreviation}.{county-town-etc}, e.g., ca.los-angeles or vx.test for test/demo machines): ``` {% endcode %} {% hint style="info" %} SLI should use co.sli {% endhint %} Then, on all machines, you'll see this prompt: {% code overflow="wrap" %} ``` Insert a USB drive into the machine. Press enter once you've done so. ``` {% endcode %} Insert a USB drive that you designate for this purpose. From here on out, we'll refer to this USB drive as the VxCertifier USB drive. After selecting the VxCertifier USB drive, a certificate signing request will be written to it. You'll then be prompted to: {% code overflow="wrap" %} ``` Remove the USB drive, take it to VxCertifier, and bring it back to this machine when prompted. Press enter once you've re-inserted the USB drive. ``` {% endcode %} Because you'll be certifying your machine at your own facility as opposed to a VotingWorks facility, you won't be able to take the USB drive to VxCertifier, our VotingWorks certification terminal. We'll need to use a remote certification process instead. You'll need to remove the VxCertifier USB drive, find the "csr-\.pem" file inside the "certs/" directory on it, and share that file with VotingWorks. This file does not contain any private information so can be shared over the internet, e.g., via email. VotingWorks will prepare a certificate given this "csr-\.pem" file and send the certificate back to you, in the form of a "cert-\.pem" file. This file, too, does not contain any private information so can be shared over the internet. You'll need to copy this "cert-\.pem" file back onto the VxCertifier USB drive, placing it in the same "certs/" directory that we pulled the "csr.pem" from. Re-inserting the USB drive into the machine and pressing enter should allow you to proceed successfully. On VxAdmin, you'll be prompted to program your first system administrator card as a last step. Remember to record the displayed PIN. On other machines, no steps remain. You'll reboot into the app after this. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.voting.works/vxsuite-tdp-v4/software-installation/imaging-machines/basic-configuration-wizard.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.