At some point, the day may come when you need a backup restored. BmuS can easily restore the files or folders. If they are unencrypted, you can simply copy them back to the original folder (or wherever you want). If they are encrypted, they will be decrypted at the same time.
Restore single file
A single file from a specific day can be restored as follows.
sudo bash ./bmus.sh --restore --date 2025-11-26 --target /mnt/workstation/decrypted --file "devices.csv"Search the backup from 11/26 explicitly for files that have devices.csv in their name and restore only those to /mnt/workstation/decrypted.
Output:
Loading configuration from: /home/pi/bmus.conf
Configuration successfully loaded
═══════════════════════════════════════════════════════════════
RESTORATION MODE ACTIVE
═══════════════════════════════════════════════════════════════
[1/5] Mounting NAS share...
NAS already mounted at: /mnt/workstation
[3/5] Searching for backup from 2025-11-26...
[29.11.2025 15:02:25] - Using date folder: /mnt/workstation/2025-11-26
Restore single file: devices.csv
[4/5] Found backups:
/mnt/workstation/2025-11-26/2025-11-26_23-00-11/netalertx/data/config/devices.csv
[5/5] [5/5] Restoring to /mnt/workstation/decrypted...
Copying devices.csv...
✓ 1 file(s) successfully restored
═══════════════════════════════════════════════════════════════
✓ Restoration successfully completed!
═══════════════════════════════════════════════════════════════
Files restored to: /mnt/workstation/decrypted
NAS unmounted
Restore latest version of a single file
The command above finds all versions of the file and restores them. This happens, for example, if there are additional backups with timestamps in the date folder and the file was backed up multiple times on that day.
If you want to find the latest version of this file (logic: starts at the specified date and searches in newer increments, if available/supported), you can add the --latest parameter.
sudo bash ./bmus.sh --restore --date 2025-11-26 --target /mnt/workstation/decrypted --file "devices.csv" --latestOutput:
Loading configuration from: /home/nhg/bmus.conf
Configuration successfully loaded
═══════════════════════════════════════════════════════════════
RESTORATION MODE ACTIVE
═══════════════════════════════════════════════════════════════
[1/5] Mounting NAS share...
NAS successfully mounted
[3/5] Searching for backup from 2025-11-16...
Restore single file: devices.csv
ℹ️ --latest active: Restore only newest of 13 versions
[4/5] Found backups:
/mnt/workstation/#recycle/encrypted/2025-11-16/2025-11-16/2025-11-16_19-24-27/netalertx/data/config/devices.csv
[5/5] Restoring to /mnt/workstation/decrypted...
Copying devices.csv...
✓ 1 file(s) successfully restored
═══════════════════════════════════════════════════════════════
✓ Restoration successfully completed!
═══════════════════════════════════════════════════════════════
Files restored to: /mnt/workstation/decrypted
NAS unmounted
Restore latest version of a folder or subfolder
Let’s say there are two timestamped subfolders in the folder.
/mnt/workstation/
├── 2025-11-27/
│ ├── 2025-11-27_10-30-00/
│ │ └── [Files]
│ └── 2025-11-17_18-00-00/
│ └── [Files]
Now you only want to restore the last or latest version of the subfolder, which is: 2025-11-17_18-00-00.
Here’s how to do it:
sudo bash ./bmus.sh --restore --date 2025-11-27 --target /mnt/workstation/decrypted --latestOutput:
Loading configuration from: /home/nhg/bmus.conf
Configuration successfully loaded
═══════════════════════════════════════════════════════════════
RESTORATION MODE ACTIVE
═══════════════════════════════════════════════════════════════
[1/5] Mounting NAS share...
NAS successfully mounted
[3/5] Searching for backup from 2025-11-27...
[29.11.2025 16:01:44] - Using date folder: /mnt/workstation/2025-11-27
[4/5] Found backups:
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/english_2025-11-27_23-02-12.lang.bak
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/bmus_encryption_2025-11-27_23-02-12.sh.bak
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/bmus_dashboard_2025-11-27_23-02-12.sh.bak
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/.bmus_credentials_2025-11-27_23-02-12.bak
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/bmus_2025-11-27_23-02-12.conf.bak
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/bmus_2025-11-27_23-02-12.sh.bak
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/netalertx/data/db/app.db-wal
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/netalertx/data/db/app.db
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/netalertx/data/db/app.db-shm
/mnt/workstation/2025-11-27/2025-11-27_23-00-02/pihole/pihole-FTL.db-wal
✓ 122 file(s) successfully restored
═══════════════════════════════════════════════════════════════
✓ Restoration successfully completed!
═══════════════════════════════════════════════════════════════
Files restored to: /mnt/workstation/decrypted
Restore a folder with all subfolders
If you want to restore a folder with its subfolders, simply get rid of the -- latest parameter.
sudo bash ./bmus.sh --restore --date 2025-11-27 --target /mnt/workstation/decryptedThis will result in the full restore of both subfolders.
/mnt/workstation/
├── 2025-11-27/
│ ├── 2025-11-27_10-30-00/
│ │ └── [Files]
│ └── 2025-11-17_18-00-00/
│ └── [Files]
Docker commands
If you are using the Docker version, the program files are locked in the container, which means you can no longer simply call it with sudo bash bmus.sh.
There are two ways to solve this problem.