v2.0.7
DTS Torque Vault — Mini PC Kiosk 24/7 Deployment
Automated, zero-touch deployment suite for provisioning Windows 10/11 Mini PCs into dedicated 24/7 Kiosk terminals running DTS Torque Vault on WSL2 (Ubuntu-22.04) and Docker Engine.
Repository Structure
mini-pc-setup/
├── setup.bat # One-click Windows bootstrapper (downloads & extracts latest release)
├── bootstrap.ps1 # PowerShell release downloader & .env initializer
├── compose.yml # Docker Compose service definitions (project: walmart)
├── .env.template # Environment variable template (copied to .env if missing)
├── README.md # Deployment & maintenance guide
├── scripts/
│ ├── install.bat # Master 7-phase Kiosk & WSL2/Docker installer
│ ├── update.bat # Zero-downtime container & image updater (preserves DB volumes)
│ └── uninstall.bat # Full system restore & Kiosk uninstaller (Auto Wipe or Custom)
└── templates/
└── startup.html # Local Kiosk splash/health-check screen before redirecting to :3000
Prerequisites
- OS: Windows 10 (21H2+) or Windows 11 (64-bit) with Microsoft Edge installed.
- BIOS / Firmware: Hardware Virtualization (
Intel VT-x/AMD-V) Enabled. - Privileges: Local Administrator account on the Mini PC.
- Network: Internet access to download Ubuntu/Docker packages and pull images from
gitea.digitoolsolutions.synology.me.
Quick Start (Fresh Mini PC Deployment)
- Copy
setup.batonto the Mini PC (or download it directly from Gitea) and double-click to run it (automatically elevates to Administrator). setup.batperforms the following automatically:- Verifies DNS and connectivity to
[https://gitea.digitoolsolutions.synology.me](https://gitea.digitoolsolutions.synology.me). - Fetches the latest published release of
lamtruong28/mini-pc-setup(prompts for Gitea credentials only if the repository/release is private). - Extracts all release assets (including hidden files such as
.env) intoC:\Apps\mini-pc-setup. - Launches
scripts\install.bat.
- Verifies DNS and connectivity to
- If WSL2 /
Ubuntu-22.04is not installed yet:- Phase 1 installs WSL2 and
Ubuntu-22.04, registers aRunOnceresume entry, and prompts to reboot the Mini PC. - Log back in as Administrator after reboot —
install.batresumes automatically.
- Phase 1 installs WSL2 and
- During installation (
install.bat):- If
.envdoes not exist, it is created from.env.templateand opened in Notepad for configuration. - Enter your Gitea registry credentials when prompted by
docker login. - Choose the Windows Kiosk account name (Default:
Torque Vault) and password (Default: blank / no password).
- If
- When prompted at the end, enter
Yto reboot immediately into Fullscreen Edge Kiosk Mode.
What install.bat Configures
| Phase | Component | Configuration Details |
|---|---|---|
| Pre-Check | Environment & Security | Verifies Edge, compose.yml, .env, templates\startup.html, Internet, BIOS Virtualization, and locks C:\Apps\mini-pc-setup ACLs to Administrators and SYSTEM. |
| Phase 1–2 | WSL2 (Ubuntu-22.04) |
Installs Ubuntu-22.04, creates dtsadmin with passwordless sudo, enables systemd=true, and sets vmIdleTimeout=-1 in .wslconfig. |
| Phase 3 | Docker Engine | Installs and holds pinned docker-ce (5:28.3.2-1~ubuntu.22.04~jammy) + docker-compose-plugin. |
| Phase 4 | App Deployment | Deploys stack under -p walmart in /opt/walmart and polls http://localhost:3000/api/v1/system/health-check/ every 30s until "Online" is returned. |
| Phase 5–6 | Kiosk Shell & Boot Task | Creates Torque Vault user, sets Windows AutoAdminLogon, locks user Shell policy directly to fullscreen Edge (C:\KioskApp\startup.html → http://localhost:3000), and registers the WSL Docker Startup Task Scheduler job (AtStartup, S4U, unlimited runtime) running C:\KioskApp\start_wsl_docker.bat. |
| Phase 7 | 24/7 Hardening | Activates High Performance power plan, disables sleep/hibernate/display/disk timeouts, and blocks automatic Windows Update reboots while logged on. |
Maintenance & Operations
Updating the Application (scripts\update.bat)
To update container images, compose.yml, .env, or templates\startup.html without losing database data:
- Log in to the Administrator account (press
Ctrl + Alt + Del→ Sign out or Switch user). - Update
.envorcompose.ymlinsideC:\Apps\mini-pc-setupif needed. - Run
C:\Apps\mini-pc-setup\scripts\update.batas Administrator:- Syncs
startup.html,compose.yml, and.env(converting CRLF to LF). - Runs
docker compose -p walmart pullandup -d --remove-orphans(preserving database volumes). - Verifies
/api/v1/system/health-check/reportsOnlineand prunes dangling Docker images.
- Syncs
Uninstalling & Restoring Desktop (scripts\uninstall.bat)
Run C:\Apps\mini-pc-setup\scripts\uninstall.bat as Administrator and select a mode:
[1] Auto Wipe All: Automatically disables Auto-Logon, deletes the Kiosk user and browser profile (C:\KioskBrowserData), removes scheduled tasks andC:\KioskApp, tears down Docker containers and volumes (down -v), restores Balanced power plan, and deletesC:\Apps\mini-pc-setup.[2] Manual / Custom: Prompts step-by-step whether to delete or restore the Kiosk user's normal Windows Desktop (explorer.exe), keep browser data, preserve database volumes, or keep the setup folder.
Troubleshooting
-
Web app (
http://localhost:3000) is unreachable after reboot:-
Open Task Scheduler as Administrator and check
WSL Docker Startup. Ensure it is configured to run under the Administrator account that installed WSL2 (notSYSTEM) with "Run whether user is logged on or not" enabled. -
Inspect backend container logs inside WSL:
wsl -d Ubuntu-22.04 -u root docker logs tv-backend-prod
-
-
Exiting Kiosk Mode for Admin Maintenance:
- With a physical keyboard: Press
Ctrl + Alt + Del→ Switch user → sign in with your Administrator account. - Touchscreen only (no physical keyboard):
- Turn the display off and back on (or press the physical power/sleep button briefly to lock the screen).
- Swipe up on the Windows Lock Screen to reveal the sign-in screen.
- Tap the Administrator account in the bottom-left corner, tap the password box (Windows On-Screen Touch Keyboard will appear automatically), and sign in.
- With a physical keyboard: Press