Files
public-setupfiles/debian-dist-upgrades/README.md
T

158 lines
3.4 KiB
Markdown
Raw Normal View History

2025-12-16 00:20:48 -06:00
# debian-dist-upgrades
2025-12-16 00:15:01 -06:00
2025-12-16 00:20:48 -06:00
## 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
---
2025-12-16 00:15:01 -06:00
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.list` entries (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
```bash
chmod +x debian-upgrade.sh
```
### 2️⃣ Run as root
```bash
sudo ./debian-upgrade.sh
```
All output is logged to:
```text
./log.txt
```
---
## 🧭 Menu Options
### Option 1 — apt upgrade
Performs a safe system update:
```bash
apt update
apt upgrade -y
apt autoremove -y
```
---
### Option 2 — apt full-upgrade
Handles dependency changes and removals:
```bash
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.
```bash
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 `tmux` or `screen`
- 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.