Personal system administration scripts for Windows and Linux. SSH configuration, monitoring, backup, and maintenance automation.
Note: Security hardening scripts are in defensive-toolkit.
git clone https://github.com/Dashtid/sysadmin-toolkit.git
cd sysadmin-toolkit
cp .env.example .env.local # Configure your values| Category | Script | Purpose |
|---|---|---|
| Monitoring | Get-SystemPerformance.ps1 | CPU, RAM, disk, network metrics with Prometheus export |
| Watch-ServiceHealth.ps1 | Service monitoring with auto-restart | |
| Test-NetworkHealth.ps1 | Connectivity, DNS, port testing | |
| Get-EventLogAnalysis.ps1 | Security and error log analysis | |
| Get-ApplicationHealth.ps1 | Application crash and version monitoring | |
| Backup | Backup-UserData.ps1 | User documents with compression |
| Backup-BrowserProfiles.ps1 | Browser bookmarks and settings | |
| Backup-DeveloperEnvironment.ps1 | VSCode, Terminal, Git, SSH configs | |
| Export-SystemState.ps1 | Drivers, registry, network, services | |
| Test-BackupIntegrity.ps1 | Backup validation and restore testing | |
| SSH | setup-ssh-agent-access.ps1 | Windows SSH agent for Git Bash |
| gitea-tunnel-manager.ps1 | Persistent SSH tunnels | |
| Setup | fresh-windows-setup.ps1 | Automated Windows 11 setup |
| export-current-packages.ps1 | Export Winget/Chocolatey packages | |
| Development | Test-DevEnvironment.ps1 | Validate dev tool installation |
| Manage-Docker.ps1 | Docker Desktop management | |
| Manage-WSL.ps1 | WSL2 backup and configuration | |
| Maintenance | system-updates.ps1 | Windows Update automation |
| Restore-PreviousState.ps1 | System restore from backup | |
| Troubleshooting | Repair-CommonIssues.ps1 | Fix DNS, network, update issues |
| Security | Get-UserAccountAudit.ps1 | User and admin account audit |
| Network | Manage-VPN.ps1 | VPN connection management |
| Reporting | Get-SystemReport.ps1 | Comprehensive system report |
| Category | Script | Purpose |
|---|---|---|
| Monitoring | pod-health-monitor.sh | Kubernetes pod health and restart detection |
| pvc-monitor.sh | PVC usage monitoring | |
| service-health-monitor.sh | Service monitoring with alerts | |
| Maintenance | system-updates.sh | APT/Snap updates with rollback |
| log-cleanup.sh | Log rotation and cleanup | |
| restore-previous-state.sh | System state restoration | |
| Docker | docker-cleanup.sh | Image cleanup with retention policy |
| GPU | nvidia-gpu-exporter.sh | NVIDIA GPU metrics for Prometheus |
| Security | security-hardening.sh | SSH, firewall, kernel hardening |
| Server | headless-server-setup.sh | Ubuntu server provisioning |
| 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 |
| SECURITY.md | Security policy and best practices |
| CONTRIBUTING.md | Coding standards and PR process |
| docs/ROADMAP.md | Feature roadmap and progress |
| docs/TROUBLESHOOTING.md | Common issues and solutions |
| Windows/ssh/ | SSH agent and tunnel setup |
| Platform | Requirements |
|---|---|
| Windows | PowerShell 7+, OpenSSH Client enabled |
| Linux | Bash 4.0+, sudo access |
MIT License - See LICENSE
Author: David Dashti | Version: 2.1.0 | Updated: 2025-12-26