Skip to content
YAMS Plus

Backup and recovery

Backups contain configuration, application databases, state and the version lock. Media is excluded by default.

Terminal window
sudo yamsplus backup --output yamsplus-$(date +%F).tar.gz.age

You enter a passphrase interactively. Because the archive contains provider and API secrets, it is encrypted before it leaves the process.

Test a restore

Section titled “Test a restore”

Restore into an isolated root first:

Terminal window
sudo yamsplus --root /srv/yamsplus-restore-test restore --yes ./yamsplus-2026-08-04.tar.gz.age
sudo yamsplus --root /srv/yamsplus-restore-test doctor --files-only

When the isolated check is green, stop the production stack, take one more backup, then restore to the production root.

Uninstall

Section titled “Uninstall”
Terminal window
sudo yamsplus uninstall --yes

This removes containers and YAMS Plus configuration while preserving /srv/yamsplus. Media deletion is a separate guarded workflow; the beta CLI refuses to do it casually.