3.4 KiB
debian-dist-upgrades
Overview
This directory is part of the public-setupfiles repository. It contains scripts, configuration files, or resources related to debian-dist-upgrades.
Usage
- Review scripts before execution
- Some files may require root or sudo privileges
- Paths, variables, or credentials may need customization
Logging & Output
Scripts may generate logs or output files in the same directory or system locations.
Safety Notes
- Always back up important data before running scripts
- Test in a non-production environment when possible
- Use at your own risk
A safe, interactive Debian system upgrade utility designed for real-world administration.
Supports standard upgrades, full upgrades, controlled distro upgrades (Debian 12 / 13), and optional Parrot Linux conversion — with logging and guardrails.
📌 Features
- ✔ Verifies the system is Debian-based before running
- ✔ Detects and displays current Debian version & codename
- ✔ Interactive menu-driven workflow
- ✔ Accepts yes / no / y / n for confirmations
- ✔ Preserves existing configuration files during upgrades
- ✔ Logs all actions and output to
./log.txt - ✔ Safe Debian 12 (Bookworm) upgrade path
- ✔ Double-confirmation for Debian 13 (Trixie – testing)
- ✔ Comments out existing
sources.listentries (never deletes) - ✔ Optional Parrot Linux conversion
- ✔ Designed to be safe over SSH
📂 Files
.
├── debian-upgrade.sh
├── README.md
└── log.txt (created at runtime)
🚀 Usage
1️⃣ Make executable
chmod +x debian-upgrade.sh
2️⃣ Run as root
sudo ./debian-upgrade.sh
All output is logged to:
./log.txt
🧭 Menu Options
Option 1 — apt upgrade
Performs a safe system update:
apt update
apt upgrade -y
apt autoremove -y
Option 2 — apt full-upgrade
Handles dependency changes and removals:
apt update
apt upgrade -y
apt full-upgrade -y
apt autoremove -y
Option 3 — Debian Distro Upgrade
Upgrade between major Debian releases.
Targets:
- Debian 12 (Bookworm – Stable)
- Debian 13 (Trixie – Testing) ⚠️ requires double confirmation
Behavior:
- Backs up
/etc/apt/sources.list - Comments out all existing repo entries
- Appends new release repositories
- Keeps existing config files
- Cleans obsolete packages
Option 4 — Convert to Parrot Linux
Converts a Debian system into Parrot OS using the official conversion script.
git clone https://gitlab.com/parrotsec/project/debian-conversion-script.git
cd debian-conversion-script
chmod +x install.sh
./install.sh
⚠️ This is a one-way conversion.
🔒 Safety Measures
- Refuses to run on non-Debian systems
- Full execution logging
- Explicit confirmations for risky operations
- Non-interactive apt with preserved configs:
--force-confold--force-confdef
- Debian 13 requires double confirmation
📝 Logs
All stdout and stderr are written to:
./log.txt
⚠️ Notes & Recommendations
- Always backup important data before distro upgrades
- For remote systems, consider running inside
tmuxorscreen - Debian 13 (Trixie) is testing — expect breakage
- Reboot may be required after kernel upgrades
📜 License
Use, modify, and distribute freely.
No warranty — you run it, you own it.