Hi, I'm Sween. 👋
I'm building and learning through my personal homelab, Sween Lab.
This repository contains scripts I've created to make managing Proxmox VE and Linux systems a little easier. I learn best by doing, experimenting, and occasionally breaking things before figuring out how to fix them. If you're the kind of person who learns through hands-on experience instead of memorizing commands, I hope these tools are useful to you too.
Every script is something I built because I wanted it for my own lab first. If it helps someone else learn or saves them some time, that's even better.
Have fun!
| Script | Purpose | Documentation |
|---|---|---|
| Proxmox Task Scheduler | Create and manage scheduled maintenance tasks using interactive menus. | View Guide |
| Proxmox Health Check | Perform a comprehensive read-only health assessment of a Proxmox host, including storage, SMART health, package updates, networking, DNS, system services, and an overall health summary. | View Guide |
| Proxmox Host & LXC Maintenance Wizard | Safely perform guided maintenance on the Proxmox host or Debian/Ubuntu LXC containers with maintenance profiles, progress tracking, automatic logging, and detailed summaries. | View Guide |
| Proxmox VM Maintenance Wizard | Run and schedule guided maintenance for Debian-family VMs through QEMU Guest Agent with logs, stopped-VM policies, and optional notifications. | View Guide |
- Interactive terminal menus
- Beginner-friendly guided workflows
- Safe defaults
- Readable output
- Automatic logging
- Responsive terminal interface
- Supports Debian and Ubuntu LXC containers
- Supports Debian-family VMs through QEMU Guest Agent
- Uses systemd timers for scheduled jobs
- Optional notification support where available
- Designed specifically for Proxmox VE
Clone the repository:
git clone https://github.com/SweenLab/personal-proxmox-scripts.gitOr run a script directly from GitHub.
bash <(curl -fsSL https://raw.githubusercontent.com/SweenLab/personal-proxmox-scripts/main/scripts/proxmox-health-check.sh)bash <(curl -fsSL https://raw.githubusercontent.com/SweenLab/personal-proxmox-scripts/main/scripts/proxmox-task-scheduler.sh)bash <(curl -fsSL https://raw.githubusercontent.com/SweenLab/personal-proxmox-scripts/main/scripts/proxmox-lxc-maintenance-wizard.sh)bash <(curl -fsSL https://raw.githubusercontent.com/SweenLab/personal-proxmox-scripts/main/scripts/proxmox-vm-maintenance-wizard.sh)Each script includes its own documentation and usage guide.
Run scripts as root on the Proxmox host unless a script guide says otherwise.
The Proxmox VM Maintenance Wizard is for normal Debian-family Linux VMs.
It supports:
- Debian
- Ubuntu
- Kali Linux
- Linux Mint
- Pop!_OS
- Raspberry Pi OS
- other Debian-like guests with
ID_LIKE=debian
It requires QEMU Guest Agent inside each target VM.
It intentionally does not update appliance-style operating systems such as:
- Home Assistant OS
- OPNsense
Use those systems' web interfaces and official update guides instead.
Detailed documentation is available in the docs directory.
- 📖 Proxmox Task Scheduler
- 📖 Proxmox Health Check
- 📖 Proxmox Host & LXC Maintenance Wizard
- 📖 Proxmox VM Maintenance Wizard
Version history and release notes are available on the GitHub Releases page.
👉 https://github.com/SweenLab/personal-proxmox-scripts/releases
- ✅ Proxmox Task Scheduler
- ✅ Proxmox Health Check
- ✅ Proxmox Host & LXC Maintenance Wizard
- ✅ Proxmox VM Maintenance Wizard
- 🚧 LXC Setup Wizard
- 🚧 Docker Installer
- 🚧 SMART Report Exporter
- 🚧 Storage Report
Suggestions, bug reports, and feature requests are always welcome.
If you find an issue or have an idea that would improve one of these scripts, feel free to open an Issue or submit a Pull Request.
These scripts are provided as-is without warranty.
Although they are designed with safe defaults and are tested in my own homelab, you should always review any script before running it in your own environment.
Make backups of important systems before performing maintenance.
Use at your own risk.
This project is licensed under the MIT License.