Troubleshooting and Debug

This page is a practical “do this first” checklist when something fails.

Example 1 — Confirm the binary you are running

proxsave --version

If that command is not found, run the binary by path:

/opt/proxsave/build/proxsave --version

Example 2 — Dry-run with debug logs

proxsave --dry-run --log-level debug

Dry-run validates configuration and simulates the workflow, but it does not create archives and it does not send notifications.

Example 3 — Real run with debug logs

proxsave --log-level debug

Example 4 — Debug an interactive workflow (restore/decrypt/install)

proxsave --restore --cli --log-level debug
proxsave --decrypt --cli --log-level debug
proxsave --install --cli --log-level debug

Example 5 — Support mode (sends log to developer)

Support mode is only available for the standard backup run (not restore/decrypt/install).

It forces debug log level and tries to send a support email with the full log attached to github-support [at] tis24.it via sendmail (a local MTA must be available).

proxsave --support

Where to look for logs

• Backup run logs: ${BASE_DIR}/log/
• Restore/decrypt logs: /tmp/proxsave/ (restore plan logs and safety backups)