Skip to content

Commit d2f3d5f

Browse files
Create New document for the tablet setup (#788)
1 parent d1644db commit d2f3d5f

File tree

1 file changed

+97
-0
lines changed

1 file changed

+97
-0
lines changed

docs/Tablet Setup.md

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# Setup Surface Go 3 Tablet
2+
3+
This documentation is a reference on how to setup a brand new computer (in this case a Surface Go 3) to use the Python repository to run the Admin and Guardian GUIs for an election. Some steps, such as "Turn Off S Mode" might not apply to the computer you are setting up. All usernames and passwords are set to xxx in this document and should be set to valid values for your own purpose.
4+
5+
## Setup Windows
6+
* When prompted for email address use
7+
* xxxx@xxxx.com
8+
* xxxx
9+
* skip protecting account
10+
* skip hello setup
11+
* pin xxxx
12+
* default privacy
13+
* skip customization
14+
* decline office 365
15+
* installs Win11 (30 min or so)
16+
17+
## Turn Off S Mode
18+
* settings -> system -> activation
19+
* opens windows store
20+
* hit Get button and wait for it to complete
21+
22+
## Windows Updates
23+
* Do all the updates (a lot of updates)
24+
* Change to best performance mode
25+
* Settings -> System -> Power and Battery
26+
* Power Mode -> Best Performance
27+
28+
## Install Hyper-V and Linux (admin only)
29+
* Go to Settings
30+
* Search for features
31+
* Go to optional features
32+
* More Windows Features
33+
* Install WSL, Virtual Machine Platform and Windows Hypervisor Platform settings
34+
* Restart windows
35+
* Go to windows store and install ubuntu
36+
* When running it the first time it will give a link to install a new kernel for WSL2
37+
* Run ubuntu and setup a user
38+
* Username: xxxx
39+
* Password: xxxx
40+
41+
## Docker Installation (admin only)
42+
* Get docker desktop and install.
43+
* In the settings (gear icon) make the following changes:
44+
* Make sure that "Start Docker Desktop when you log in" is on
45+
* Make sure that "Use the WSL 2 based engine" is on
46+
47+
## Developer Tools
48+
* Command prompt -> python3 (install from windows store)
49+
* Install chrome (does not need to be set to current browser)
50+
* Install VS Code
51+
* Git
52+
* https://git-scm.com/download/win
53+
* Install chocolatey using powershell command from https://chocolatey.org/install
54+
* Install make
55+
* choco install make
56+
* Install poetry (powershell) https://python-poetry.org/docs
57+
* Add to path (See "Set Environment Variables" below on steps to get to the path)
58+
59+
## Download Python Source Code
60+
* Open a Command prompt and use the following commands
61+
* mkdir code
62+
* cd code
63+
* git clone https://github.com/microsoft/electionguard-python
64+
65+
66+
## Terminal Settings
67+
* Open up Terminal
68+
* Go to settings in Terminal
69+
* Default Profile => Command Prompt
70+
* Profiles (left) -> Defaults
71+
* Run this profile as Admin -> on
72+
* Starting Starting directory to be directory where source code is downloaded
73+
* Hit "Save" button at the bottom of the window
74+
75+
## User Interface Changes
76+
* Change touch keyboard to traditional instead of default
77+
* Go into resize (using the gear icon) and set the zoom to 200 (max value)
78+
79+
## Set Environment Variables
80+
* Go to Settings
81+
* Search for environment
82+
* Select "Edit the system environment variables"
83+
* Select the button "Environment Variables"
84+
* Select "New…"
85+
* Create the following settings
86+
* EG_DB_PASSWORD = xxxx
87+
* EG_DB_HOST = 10.10.0.100
88+
* EG_IS_ADMIN = true for an admin and false if guardian
89+
* admin only - EG_DB_DIR = ./database
90+
91+
## Set Python Code
92+
* Open Terminal and run the following commands
93+
* make environment
94+
* There will be an error at the end. This is normal
95+
* poetry run eg
96+
* should show the help for the eg command
97+

0 commit comments

Comments
 (0)