Navidrome Restore Role

Restores Navidrome from archives produced by navidrome_backup, reconstituting data/config/systemd/Traefik wiring and optionally forcing a full rescan.

Features

• Selects an explicit archive or the most recent *.tar.gz under {{ navidrome_restore_root }}.

• Extracts into a staging area, rsyncs data/config/logs, restores Traefik + systemd units, and restarts the service.

• Optional full rescan after restore to refresh the music index.

Usage

- hosts: media
  become: true
  roles:
    - role: local.ops_library.navidrome_restore
      vars:
        navidrome_restore_root: /opt/backups/navidrome
        navidrome_restore_archive: "{{ archive | default('latest') }}"
        navidrome_restore_force_full_rescan: true

Key Variables

Variable	Default	Description
navidrome_restore_root	/opt/backups/navidrome	Location of backup archives.
navidrome_restore_archive	latest	Archive filename or latest to pick the newest.
navidrome_restore_cleanup	true	Remove staging directory after restore.
navidrome_restore_restart	true	Restart service after restore.
navidrome_restore_force_full_rescan	false	Run navidrome scan --full after restore.