Personal system administration scripts for Windows and Linux. Narrow scope: fresh-machine setup, weekly update automation, a Docker convenience wrapper, and a GPU exporter for the lab server.
Note: Security hardening lives in defensive-toolkit. Monitoring and backup happen on the lab server via Prometheus/Grafana and Velero, not here.
2026-06-14: the toolkit was deliberately culled. Monitoring/reporting/security/most-backup/VPN/WSL/Test-DevEnvironment scripts were removed because they duplicated native tools (Task Manager, Event Viewer,
wsl.exe, Settings) or the lab-server stack. See BACKLOG.md for the new scope and rationale.
| Category | Script | Purpose |
|---|---|---|
| Setup | fresh-windows-setup.ps1 | Automated Windows 11 setup (Winget + Chocolatey) |
| export-current-packages.ps1 | Export installed Winget/Choco packages to a list | |
| install-from-exported-packages.ps1 | Restore an exported package list on a fresh box | |
| Compare-SoftwareInventory.ps1 | Diff two package inventories | |
| Maintenance | system-updates.ps1 | Weekly Winget/Choco/Windows Update automation |
| Install-SystemUpdatesTask.ps1 | Register system-updates.ps1 as a scheduled task |
|
| Backup | Backup-DeveloperEnvironment.ps1 | Snapshot VSCode, Terminal, Git, SSH configs before a rebuild |
| Development | Manage-Docker.ps1 | Docker Desktop start/stop/cleanup helper |
| remote-development-setup.ps1 | Configure SSH client for remote development | |
| Network | Set-StaticIP.ps1 | One-shot static IP/DNS/gateway helper |
| Troubleshooting | Repair-CommonIssues.ps1 | DNS, network, and Windows Update fix-it routines |
Scope is narrow on purpose: the lab server (q-lab) covers most operational needs via Prometheus/Grafana/Velero/k9s; the survivors here are the bits those tools don't cover.
| Category | Script | Purpose |
|---|---|---|
| GPU | nvidia-gpu-exporter.sh | NVIDIA GPU metrics for Prometheus (scraped by Grafana) |
| Maintenance | disk-cleanup.sh | APT cache + journal + Docker leftover cleanup |
| Server | headless-server-setup.sh | Ubuntu server provisioning for a fresh q-lab-style box |
| Platform | Module | Purpose |
|---|---|---|
| Windows | CommonFunctions.psm1 | Logging, admin checks, Prometheus export |
| Windows | ErrorHandling.psm1 | Contextual errors, retry logic |
| Linux | common-functions.sh | Logging, validation, Prometheus export |
| Document | Purpose |
|---|---|
| QUICKSTART.md | 5-minute setup guide |
| BACKLOG.md | Tactical work queue and post-cull scope |
| SECURITY.md | Security policy and best practices |
| CONTRIBUTING.md | Coding standards and PR process |
| docs/ROADMAP.md | Strategic direction (post-cull) |
| docs/TROUBLESHOOTING.md | Common issues and solutions |
| Platform | Requirements |
|---|---|
| Windows | PowerShell 7+, OpenSSH Client enabled |
| Linux | Bash 4.0+, sudo access |
MIT License - See LICENSE
Author: David Dashti | Version: 3.0.0 | Updated: 2026-06-14