2026-11-14 22:12:04 +07:00
2026-11-11 23:43:28 +07:00
2026-11-14 22:12:04 +07:00
2026-11-14 22:12:04 +07:00

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-x or AMD-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

  1. Copy scripts\setup.bat onto the Mini PC (or download it from the Gitea Release Assets).
  2. Double-click setup.bat and click Yes on the UAC Administrator prompt.
    • If the repository is Private, enter your Gitea credentials once when prompted.
  3. The bootstrapper downloads the Latest Release into C:\Apps\mini-pc-setup\, copies .env.template to .env (opening Notepad so you can configure site-specific values), and launches scripts\install.bat.

Option B: Manual Deployment from C:\Apps\mini-pc-setup\

  1. Extract the release package to C:\Apps\mini-pc-setup\.
  2. Double-click scripts\install.bat (auto-creates .env from .env.template if missing).

Installation Phases (scripts\install.bat)

  1. Pre-Flight Checks: Verifies templates\startup.html, compose.yml, .env, Microsoft Edge, Internet access, and BIOS Virtualization.
  2. Phase 1 — WSL2 & Ubuntu-22.04 (First-time setup only): Installs WSL2 + Ubuntu-22.04, registers a RunOnce resume entry, and reboots. Sign back in as Administrator and the installer automatically resumes.
  3. Phase 2 — Docker, Containers & Kiosk Setup:
    • Logs into gitea.digitoolsolutions.synology.me, deploys containers to /opt/walmart, and registers the DTS_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.
  4. Final Reboot: Type Y and 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:

  1. Press Ctrl + Alt + Del.
  2. Click Switch user.
  3. Select the Administrator account in the bottom-left corner and sign in.

4. Updating the Application (scripts\update.bat)

  1. Switch to the Administrator account (see Section 3).
  2. Update compose.yml, .env, or templates\startup.html in C:\Apps\mini-pc-setup\ if changed.
  3. Double-click scripts\update.bat.
  4. Verification: Confirm all 4 steps complete and docker ps shows all containers in the Up state. Reboot to reload the Kiosk UI.

5. Uninstalling / Restoring Normal Windows Mode (scripts\uninstall.bat)

  1. Switch to the Administrator account (see Section 3).
  2. Double-click scripts\uninstall.bat.
  3. Answer the cleanup prompts (Y/N) for deleting the Kiosk user account, removing C:\KioskApp & C:\KioskBrowserData, and unregistering Ubuntu-22.04.
  4. Type Y to 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.
S
Description
No description provided
Readme
139 KiB
2026-11-19 23:21:47 -08:00
Languages
Batchfile 93.6%
HTML 6.4%