Simple Repair Shop – Windows Install<\/b><\/p>
================================<\/p>
Full ticketing app for a computer repair shop. Runs on any modern Windows PC,<\/p>
no server, no monthly hosting cost, no cPanel.<\/p>
————————————————————<\/p>
QUICK START (5 minutes)<\/b><\/p>
————————————————————<\/p>
1. Unzip this bundle wherever you want the app to live, for example:<\/b><\/p>
C:Workshop-OS<\/p>
2. Double-click: Install-Workshop-OS.bat<\/b><\/p>
The installer will:<\/p>
– If Python 3 isn’t already installed, ask permission and then<\/p>
download + silently install Python 3.11 for the current user<\/p>
(no admin required)<\/p>
– Create a Python virtual environment<\/p>
– Install the app dependencies (about 1 minute)<\/p>
– Generate a random JWT secret and write .env<\/p>
– Put a “Simple Repair Shop” shortcut on your Desktop<\/p>
– Set the app to auto-start when you log into Windows<\/p>
– Start the server and open http:\/\/localhost:8001<\/p>
3. On the first-run screen, fill in your admin email, password, and shop name.<\/b><\/p>
From any other PC on the shop’s WiFi, techs open:<\/p>
http:\/\/<this-PC’s-IP>:8001<\/p>
The installer prints the IP address at the end.<\/p>
————————————————————<\/p>
DAY-TO-DAY USE<\/b><\/p>
————————————————————<\/p>
Open-Workshop-OS.bat<\/b> Opens the app in your browser<\/p>
(starts the server first if it isn’t running)<\/p>
Start-Workshop-OS.bat <\/b> Starts the server manually<\/p>
Stop-Workshop-OS.bat<\/b> Stops the server<\/p>
Uninstall-Workshop-OS.bat<\/b> Removes shortcuts & stops the server (keeps data)<\/p>
The server auto-starts every time you log into Windows.<\/p>
————————————————————<\/p>
DYMO LABEL PRINTING<\/b><\/p>
————————————————————<\/p>
Simple Repair Shop auto-prints a 2-1\/4″ x 1-1\/4″ label to a DYMO LabelWriter<\/p>
every time a ticket is saved. On each PC that will print:<\/p>
1. Install DYMO Connect for Desktop from dymo.com<\/p>
2. Load 2-1\/4″ x 1-1\/4″ Multi-Purpose labels (e.g. DYMO 30334)<\/p>
3. Open Simple Repair Shop -> Settings -> DYMO Printer -> Test Print<\/p>
If DYMO Connect isn’t running, the browser falls back to a normal print<\/p>
dialog with the same label layout.<\/p>
————————————————————<\/p>
UPDATING<\/b><\/p>
————————————————————<\/p>
Sign in as admin -> Settings -> App Updates -> upload the new<\/p>
Simple Repair Shop.zip. The app:<\/p>
* Snapshots your database to backupspre-update-<timestamp>.db<\/p>
* Replaces the app files (keeps data and backups untouched)<\/p>
* Exits itself; the supervisor auto-relaunches with the new code<\/p>
You’ll see the new version number in Settings after a few seconds.<\/p>
————————————————————<\/p>
BACKUPS<\/b><\/p>
————————————————————<\/p>
Your database is a single file: dataworkshop-os.db<\/p>
* Manual backup: Settings -> Backup & Restore -> Download<\/p>
(produces a JSON envelope you can restore anywhere)<\/p>
* Byte-exact snapshot: stop the server, copy dataworkshop-os.db,<\/p>
start it again<\/p>
* A pre-update .db file lands in backups every time you update<\/p>
————————————————————<\/p>
TROUBLESHOOTING<\/b><\/p>
————————————————————<\/p>
“Python is not installed”<\/b><\/p>
The installer offers to auto-install Python 3.11 (per-user, no admin).<\/p>
If you decline, install Python 3.10+ from python.org (tick “Add to PATH”)<\/p>
and re-run Install-Workshop-OS.bat.<\/p>
“pip install failed”<\/b><\/p>
Usually a firewall \/ antivirus blocking pip from reaching pypi.org.<\/p>
Whitelist Python and try Install-Workshop-OS.bat again.<\/p>
Browser shows “This site can’t be reached”<\/b><\/p>
Run Start-Workshop-OS.bat manually and wait 5 seconds.<\/p>
If it still won’t come up, open tmpworkshop-os.log to see why.<\/p>
Port 8001 is already in use<\/b><\/p>
Edit .env, change nothing (there’s no port setting there yet),<\/p>
then edit supervisor.py and change –port 8001 to something free<\/p>
like 8010. Update the shortcut URLs to match.<\/p>
Firewall pop-up when the app starts<\/b><\/p>
Allow Python on “Private networks” so other shop PCs can reach it.<\/p>
————————————————————<\/p>
WHERE THINGS LIVE<\/b><\/p>
————————————————————<\/p>
.venv Python virtual environment (created by installer)<\/p>
backendserver.py The FastAPI app<\/p>
backendrequirements.txt Python dependencies (pip installs from this)<\/p>
static Pre-built React frontend<\/p>
dataworkshop-os.db Your database (back this up!)<\/p>
backups Manual + pre-update snapshots<\/p>
tmpworkshop-os.log Server log (open with Notepad)<\/p>
.env Configuration (JWT secret, ports, shop name)<\/p>
VERSION Current build marker (shown in Settings)<\/p>
\n