v2.0.3
DTS Torque Vault — Mini PC Kiosk Deployment & Maintenance Guide (24/7)
Automated, idempotent deployment scripts to provision a fresh Windows Mini PC into a dedicated 24/7 Kiosk appliance running WSL2 (Ubuntu-22.04), Docker Engine 28.3.2, and full-screen Microsoft Edge with persistent session storage.
1. Repository & Deployment Structure
mini-pc-setup/
├── .gitignore # Prevents committing real .env credentials
├── .env.template # Environment variable template (copied to .env on setup)
├── compose.yml # Docker Compose service definitions
├── Readme.md # Technician deployment & maintenance guide
├── CheckList.md # Unit commissioning & QA sign-off checklist
├── templates/
│ └── startup.html # Kiosk splash/health-check screen before app redirect
└── scripts/
├── setup.bat # 1-click Gitea Latest Release bootstrapper for technicians
├── bootstrap.ps1 # Downloads Latest Release to C:\Apps\mini-pc-setup\
├── install.bat # Master all-in-one deployment script
├── update.bat # Updates containers, configs, and startup.html
└── uninstall.bat # Reverts Kiosk mode and restores normal Windows
Critical Pre-Deployment Notes
- Administrator & Internet: Sign in using a local Administrator account with an active Internet connection.
- BIOS Virtualization: Hardware Virtualization (
Intel VT-xorAMD-V) must be enabled in BIOS.- Local Execution: All files are extracted to
C:\Apps\mini-pc-setup\so installation survives the mandatory WSL2 reboot without requiring a USB drive to remain plugged in.
2. Fresh Mini PC Installation
Option A: 1-Click Deployment via Gitea Latest Release (Recommended)
- Copy
scripts\setup.batonto the Mini PC (or download it from the Gitea Release Assets). - Double-click
setup.batand click Yes on the UAC Administrator prompt.- If the repository is Private, enter your Gitea credentials once when prompted.
- The bootstrapper downloads the Latest Release into
C:\Apps\mini-pc-setup\, copies.env.templateto.env(opening Notepad so you can configure site-specific values), and launchesscripts\install.bat.
Option B: Manual Deployment from C:\Apps\mini-pc-setup\
- Extract the release package to
C:\Apps\mini-pc-setup\. - Double-click
scripts\install.bat(auto-creates.envfrom.env.templateif missing).
Installation Phases (scripts\install.bat)
- Pre-Flight Checks: Verifies
templates\startup.html,compose.yml,.env, Microsoft Edge, Internet access, and BIOS Virtualization. - Phase 1 — WSL2 & Ubuntu-22.04 (First-time setup only): Installs WSL2 +
Ubuntu-22.04, registers aRunOnceresume entry, and reboots. Sign back in as Administrator and the installer automatically resumes. - Phase 2 — Docker, Containers & Kiosk Setup:
- Logs into
gitea.digitoolsolutions.synology.me, deploys containers to/opt/walmart, and registers theDTS_WSL_Docker_AutoStart(SYSTEM) boot task. - Prompts for the Kiosk username (default:
Torque Vault) and optional password (avoid Batch special characters&,|,<,>,^,%). If switching to a new Kiosk username, the previous Kiosk user's normal Windows Desktop is automatically restored. - Hardens 24/7 operation: activates High Performance power plan, disables Sleep, Hibernate, Display Timeout, and USB Selective Suspend, and blocks Windows Update auto-reboots while logged on.
- Logs into
- Final Reboot: Type
Yand press Enter. The Mini PC boots directly into the full-screen Kiosk application.
3. Switching to Administrator for Maintenance
While the Mini PC is running in full-screen Kiosk mode:
- Press
Ctrl + Alt + Del. - Click Switch user.
- Select the Administrator account in the bottom-left corner and sign in.
4. Updating the Application (scripts\update.bat)
- Switch to the Administrator account (see Section 3).
- Update
compose.yml,.env, ortemplates\startup.htmlinC:\Apps\mini-pc-setup\if changed. - Double-click
scripts\update.bat. - Verification: Confirm all 4 steps complete and
docker psshows all containers in theUpstate. Reboot to reload the Kiosk UI.
5. Uninstalling / Restoring Normal Windows Mode (scripts\uninstall.bat)
- Switch to the Administrator account (see Section 3).
- Double-click
scripts\uninstall.bat. - Answer the cleanup prompts (
Y/N) for deleting the Kiosk user account, removingC:\KioskApp&C:\KioskBrowserData, and unregisteringUbuntu-22.04. - Type
Yto reboot. Windows returns to the standard login screen with Auto-Logon disabled and the power plan reset to Balanced.
6. Quick Troubleshooting
| Symptom | Resolution | |
|---|---|---|
Hardware Virtualization is DISABLED in BIOS |
Reboot into BIOS/UEFI, enable Intel VT-x or AMD-V, save, and re-run scripts\install.bat. |
|
Kiosk stays on startup.html for > 1 minute |
Verify LAN/Wi-Fi connectivity. Switch to Administrator and run scripts\update.bat to verify containers in /opt/walmart. |
|
| Stops at Windows login screen (no Auto-Logon) | Sign in as Administrator and re-run scripts\install.bat. Ensure the Kiosk password does not contain &, ` |
, <, >, ^, or %`. |
| USB Dongle / Scanner disconnects when idle | Re-run scripts\install.bat to ensure High Performance is active and USB Selective Suspend is Disabled. |