🧪 Pre-beta · Host backup & restore test thread

[MacRimi]

🇪🇸 Español (click para expandir / contraer)

¡Hola! Este hilo está dedicado a probar la nueva funcionalidad de copia y restauración del host (PBS, Borg y Local) más las correcciones que acompañan a esta pre-beta. Vuestro feedback aquí nos permite cazar los casos extremos antes de promover la build a release estable.

⚠️ Probadlo en un equipo de laboratorio o no crítico. El proceso de restauración reescribe /etc/pve, regenera el initramfs y (si marcáis la casilla destructiva) destruye VMs/LXCs creadas después del backup. Aseguraos de tener una copia de seguridad funcional del host de pruebas antes de empezar.

---

🎯 Qué se necesita que probéis

• Crear copias a todos los backends que tengáis disponibles:
  • Local (/var/lib/vz/dump o ruta personalizada)
  • PBS (cifrada y sin cifrar, programada y manual)
  • Borg (cifrada repokey y sin cifrar)
• Inspeccionar una copia en el Monitor (botón View contents, sección Rollback plan).
• Restaurar una copia: tanto Complete restore como Custom by paths.
• Probar el rollback destructivo (Complete restore + casilla I understand…) en un host donde hayáis creado una VM o LXC después del backup — esa VM debería destruirse durante la restauración.
• Borrar una copia desde el modal Inspect del Monitor (PBS forget / Borg delete / archivo local).

Si además ejercitáis el flujo de GPU passthrough (Switch GPU mode → VFIO → restaurar un backup en modo LXC), el reporte resulta especialmente valioso.

Si una restauración falla en cualquiera de estos escenarios, es el tipo de reporte que se necesita.

---

📦 Cómo instalar la pre-beta

# En el host Proxmox de pruebas:
bash <(curl -fsSL https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux_beta.sh)

Después de instalar:

• TUI: menu → Host Backup.
• Monitor: https://proxmox-host:8008 → pestaña Host Backup.

---

📋 Tras cada restauración — lanzad el debug y pegadlo aquí

Da igual que la restauración haya ido bien o haya fallado: después de cada restore, por favor lanzad el script de debug y pegad el contenido en este hilo. Así se visualizarán tanto los debugs OK (sirven de referencia de "esto funcionó") como los debugs con errores (los que nos permiten arreglar bugs). Muchos fallos son sutiles y solo se detectan comparando la salida del script con un caso sano. Lanzadlo por favor lo antes posible y sin reiniciar el host entre medias, para que los logs y el estado capturados sigan reflejando lo que pasó.

Paso 1 · Lanzad el script

bash /usr/local/share/proxmenux/scripts/utilities/proxmenux_debug.sh > /tmp/proxmenux-debug.txt
cat /tmp/proxmenux-debug.txt

El script es read-only (no ejecuta ninguna acción que modifique el host), y la salida se redacta automáticamente: nombre del host → <host>, IPv4 → <ip>, MAC → <mac> y los patrones password= / passphrase= / token= → <redacted>. Podéis auditar el código del script aquí: https://github.com/MacRimi/ProxMenux/blob/develop/scripts/utilities/proxmenux_debug.sh

Paso 2 · Pegad el snapshot de debug en este hilo

Responded al hilo pegando el contenido completo de /tmp/proxmenux-debug.txt dentro de un bloque de código triple-backtick (así GitHub respeta el formato):

```
…aquí el contenido del fichero…
```

Con eso es suficiente para empezar a analizar. Si os apetece añadir una frase corta de contexto ("falló al pulsar Complete restore") o una captura del Monitor, mejor — pero no es obligatorio.

---

❓ FAQ

¿Es seguro pegar la salida del debug en público?
El script redacta automáticamente hostname, IPs, MACs y los patrones obvios de credenciales antes de imprimir. No incluye configs de VMs/LXCs, contraseñas de PBS, passphrases de Borg, keyfiles de encriptación, ni tokens de Telegram/Discord. Releed el fichero si queréis comprobación extra.

¿El script de debug modifica algo en mi host?
No. Solo lee archivos y ejecuta lspci / dmesg / journalctl / sqlite3 … SELECT. No hay ninguna escritura en disco más allá del fichero /tmp/proxmenux-debug.txt que vosotros mismos generáis.

---

Gracias por colaborar 🙏

🇬🇧 English (click to expand / collapse)

Welcome! This thread is dedicated to testing the new Host backup / restore feature (PBS, Borg and Local backends) plus the bugfixes shipped in this pre-beta build. Your feedback here lets us catch edge cases before promoting the build to a stable release.

⚠️ Run this on a lab / non-critical host. The restore flow rewrites /etc/pve, regenerates initramfs and (when you opt in) destroys guests created after the backup. Have a working backup of the test host before you start.

---

🎯 What needs to be tested

• Create backups to all the backends you have available:
  • Local (/var/lib/vz/dump or a custom path)
  • PBS (encrypted and non-encrypted, scheduled and manual)
  • Borg (encrypted repokey and non-encrypted)
• Inspect a backup in the Monitor (View contents button, Rollback plan section).
• Restore a backup: both Complete restore and Custom by paths.
• Test the destructive rollback (Complete restore + the I understand… checkbox) on a host where you created a VM or LXC after the backup — that VM should be destroyed during the restore.
• Delete a backup from the Monitor's Inspect modal (PBS forget / Borg delete / local file).

If you also exercise the GPU passthrough flow (Switch GPU mode → VFIO → restore an LXC-mode backup), the report is especially valuable.

If a restore fails in any of these scenarios, that's the kind of report worth posting.

---

📦 How to install the pre-beta

# On the test Proxmox host:
bash <(curl -fsSL https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux_beta.sh)

After install:

• Shell TUI: menu → Host Backup.
• Monitor: https://proxmox-host:8008 → Host Backup tab.

---

📋 After every restore — run the debug helper and paste it here

It doesn't matter whether the restore went smoothly or broke: after every restore, please run the debug helper and paste the output in this thread. That way both clean snapshots (a "this worked" baseline) and broken ones (the ones that help track bugs down) become visible side by side. Many bugs are subtle and only show up when comparing a failing snapshot against a working one. Please run it as soon as possible and without rebooting the host in between, so the captured logs and state still reflect what happened.

Step 1 · Run the script

bash /usr/local/share/proxmenux/scripts/utilities/proxmenux_debug.sh > /tmp/proxmenux-debug.txt
cat /tmp/proxmenux-debug.txt

The helper is read-only (no commands are executed on the host), and the output is redacted automatically: hostname → <host>, IPv4 → <ip>, MAC → <mac>, and password= / passphrase= / token= patterns → <redacted>. You can audit the script source here: https://github.com/MacRimi/ProxMenux/blob/develop/scripts/utilities/proxmenux_debug.sh

Step 2 · Paste the debug snapshot in this thread

Reply to the thread pasting the full contents of /tmp/proxmenux-debug.txt inside a triple-backtick code block (so GitHub keeps the formatting):

```
…file contents here…
```

That alone is enough for us to start analysing. If you want to add a short context line ("it broke when I clicked Complete restore") or a screenshot, even better — but it's not required.

---

❓ FAQ

Is the debug output safe to paste publicly?
The helper redacts hostname, IPs, MACs and obvious credential patterns before printing. It does not include VM/LXC config files, PBS passwords, Borg passphrases, encryption keys or the Telegram/Discord tokens. Re-read the file if you want extra reassurance.

Will the debug helper change anything on my host?
No. It only reads files, runs lspci / dmesg / journalctl / sqlite3 … SELECT. There is no mutation anywhere beyond the /tmp/proxmenux-debug.txt file you generate yourself.

---

Thanks for helping shape this release 🙏