Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.
Message added by KluthR,

[Plugin] Appdata.Backup

Featured Replies

I just wanted to pop in to say, thank you so much for this plugin. I have had it save me from complete data loss more than once (once due to a settings issue with another plugin and once from my own stupidity). I really appreciate not having to start over from scratch on my containers and only needing to recover data that might be missing since my last backup, which is much easier.

  • Replies 2.2k
  • Views 363.5k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • Feature freeze I have less and less time for a complete care of this plugin. You already noticed this with the fact, that announced features were not implemented yet. Another reason is, that I will mo

  • The new update is coming It been a while since the last stable update. There were some betas (never got feedback though) but I had other work to do the last weeks. I tested the major changes agai

  • 2023.08.28 should fix the docker auto update issue.

Posted Images

On 2/5/2025 at 1:20 AM, Glassed Silver said:

  

So I still have the issue with the container group order not getting saved, however this time I have some debug info, @KluthR. 😀

I used the new "?debugForm" feature to obtain telemetry, here's what saving the page returned for my MariaDB group:

containerGroupOrder%5BMariaDB%5D=containerGroupOrder%5BMariaDB%5D%5B%5D%3Dmariadb%26containerGroupOrder%5BMariaDB%5D%5B%5D%3DDirectus%26containerGroupOrder%5BMariaDB%5D%5B%5D%3Dlychee

Sadly the order stays like this: Directus, lychee, mariadb, so precisely the opposite of what's needed.

 

Hi,

 

I have same issue.  I am on 6.12.13 and the order of container start/stop is just alphabetical, it won't save the re-ordering when I shuffle them around.

@KluthR I've tried digging through this massive thread and attempted what I could for solutions that could work for my issue, but I am still having difficulty getting the plugin to work. I have a debug log sent to you as: 61b1d6a0-3359-4c62-af43-66ce9faba485

 

Below is the full text of the log:

[10.02.2025 08:47:44][ℹ️][Main] 👋 WELCOME TO APPDATA.BACKUP!! :D
[10.02.2025 08:47:44][ℹ️][Main] Backing up from: /mnt/user/appdata, /mnt/cache/appdata
[10.02.2025 08:47:44][ℹ️][Main] Backing up to: /mnt/user/backup/ab_20250210_084744
[10.02.2025 08:47:44][][Main] Cannot create destination folder!
[10.02.2025 08:47:44][ℹ️][Main] Checking retention...
[10.02.2025 08:47:44][ℹ️][Main] DONE! Thanks for using this plugin and have a safe day ;)
[10.02.2025 08:47:44][ℹ️][Main] ❤️

 

I have tried shutting down all containers, using the Docker Safe Permissions, and running the default Unraid permissions plugin to no avail. Can you help? I want to upgrade to Unraid 7.0, but I don't want to do so without running a backup. I'd appreciate any help you can provide.

  • Author

Could you post a „ls -la /mnt/user/backup“? Somehow the plugin cant create the directory there.

 

and a „df -h“.

On 2/10/2025 at 10:05 AM, KluthR said:

Could you post a „ls -la /mnt/user/backup“? Somehow the plugin cant create the directory there.

 

and a „df -h“.

@KluthR Here's the output from each command in the terminal:
 

root@SNDS:~# ls -la /mnt/user/backup
total 13731184
drwxrwxrwx 1 nobody users       1972 Dec 10 03:29 ./
drwxrwx--- 1 nobody users        119 Feb 10 12:40 ../
-rw-rw-rw- 1 nobody users     110160 Apr 29  2024 Notifiarr.tar.gz
drwxrwxrwx 1 nobody users       2000 Nov  5 03:46 ab_20241104_230001-failed/
drwxrwxrwx 1 nobody users       2000 Nov 12 02:56 ab_20241111_230001-failed/
drwxrwxrwx 1 nobody users       2000 Nov 19 03:46 ab_20241118_230001-failed/
drwxrwxrwx 1 nobody users       1228 Nov 25 23:01 ab_20241125_230001-failed/
drwxrwxrwx 1 nobody users       1228 Dec  9 23:01 ab_20241209_230001-failed/
-rw-rw-rw- 1 nobody users  132511906 Apr 29  2024 bazarr.tar.gz
-rw-rw-rw- 1 nobody users    4897559 Apr 29  2024 binhex-krusader.tar.gz
-rw-rw-rw- 1 nobody users 6287639831 Apr 29  2024 binhex-lidarr.tar.gz
-rw-rw-rw- 1 nobody users     351697 Apr 29  2024 binhex-overseerr.tar.gz
-rw-rw-rw- 1 nobody users 6480799343 Apr 29  2024 binhex-plexpass.tar.gz
-rw-rw-rw- 1 nobody users   11323560 Apr 29  2024 binhex-prowlarr.tar.gz
-rw-rw-rw- 1 nobody users   17877980 Apr 29  2024 binhex-radarr.tar.gz
-rw-rw-rw- 1 nobody users        999 Apr 29  2024 binhex-rclone.tar.gz
-rw-rw-rw- 1 nobody users  384868240 Apr 29  2024 binhex-readarr.tar.gz
-rw-rw-rw- 1 nobody users   29711750 Apr 29  2024 binhex-sonarr.tar.gz
-rw-rw-rw- 1 nobody users       5747 Apr 29  2024 config.json
-rw-rw-rw- 1 nobody users       5443 Apr 29  2024 homarr.tar.gz
-rw-rw-rw- 1 nobody users       4420 Apr 29  2024 my-Krusader.xml
-rw-rw-rw- 1 nobody users       2879 Apr 29  2024 my-Notifiarr.xml
-rw-rw-rw- 1 nobody users       2328 Apr 29  2024 my-Plex-Media-Server.xml
-rw-rw-rw- 1 nobody users       2553 Apr 29  2024 my-bazarr.xml
-rw-rw-rw- 1 nobody users       3559 Apr 29  2024 my-binhex-krusader.xml
-rw-rw-rw- 1 nobody users       2612 Apr 29  2024 my-binhex-lidarr.xml
-rw-rw-rw- 1 nobody users       2272 Apr 29  2024 my-binhex-overseerr.xml
-rw-rw-rw- 1 nobody users       2856 Apr 29  2024 my-binhex-plexpass.xml
-rw-rw-rw- 1 nobody users       2282 Apr 29  2024 my-binhex-prowlarr.xml
-rw-rw-rw- 1 nobody users       2427 Apr 29  2024 my-binhex-radarr.xml
-rw-rw-rw- 1 nobody users       4746 Apr 29  2024 my-binhex-rclone.xml
-rw-rw-rw- 1 nobody users       2634 Apr 29  2024 my-binhex-readarr.xml
-rw-rw-rw- 1 nobody users       2553 Apr 29  2024 my-binhex-sabnzbd.xml
-rw-rw-rw- 1 nobody users       2704 Apr 29  2024 my-binhex-sonarr.xml
-rw-rw-rw- 1 nobody users       4283 Apr 29  2024 my-homarr.xml
-rw-rw-rw- 1 nobody users       2666 Apr 29  2024 my-lidarr.xml
-rw-rw-rw- 1 nobody users       1992 Apr 29  2024 my-overseerr.xml
-rw-rw-rw- 1 nobody users       2298 Apr 29  2024 my-prowlarr.xml
-rw-rw-rw- 1 nobody users       2453 Apr 29  2024 my-radarr.xml
-rw-rw-rw- 1 nobody users       2402 Apr 29  2024 my-recyclarr.xml
-rw-rw-rw- 1 nobody users       2308 Apr 29  2024 my-sabnzbd.xml
-rw-rw-rw- 1 nobody users       2680 Apr 29  2024 my-sonarr.xml
-rw-rw-rw- 1 nobody users       1879 Apr 29  2024 my-tautulli.xml
-rw-rw-rw- 1 nobody users       4789 Apr 29  2024 my-tdarr.xml
-rw-rw-rw- 1 nobody users       4213 Apr 29  2024 my-tdarr_node.xml
-rw-rw-rw- 1 nobody users       2569 Apr 29  2024 my-whisper-asr-webservice.xml
-rw-rw-rw- 1 nobody users   47701676 Apr 29  2024 recyclarr.tar.gz
-rw-rw-rw- 1 nobody users    3033589 Apr 29  2024 sabnzbd.tar.gz
-rw-rw-rw- 1 nobody users  526455761 Apr 29  2024 snds-ssd-flash-backup-20240429-2323.zip
-rw-rw-rw- 1 nobody users      11933 Apr 29  2024 tautulli.tar.gz
-rw-rw-rw- 1 nobody users     947001 Apr 29  2024 tdarr.tar.gz
-rw-rw-rw- 1 nobody users      34009 Apr 29  2024 tdarr_node.tar.gz
-rw-rw-rw- 1 nobody users        684 Apr 29  2024 vm_meta.tgz
-rw-rw-rw- 1 nobody users  132277752 Apr 29  2024 whisper-asr-webservice.tar.gz
root@SNDS:~# df -h
Filesystem      Size  Used Avail Use% Mounted on
rootfs           63G  3.3G   60G   6% /
tmpfs           128M   12M  117M   9% /run
/dev/sda1        60G  584M   60G   1% /boot
overlay          63G  3.3G   60G   6% /lib
overlay          63G  3.3G   60G   6% /usr
devtmpfs        8.0M     0  8.0M   0% /dev
tmpfs            63G     0   63G   0% /dev/shm
tmpfs           128M   31M   98M  24% /var/log
tmpfs           1.0M     0  1.0M   0% /mnt/disks
tmpfs           1.0M     0  1.0M   0% /mnt/remotes
tmpfs           1.0M     0  1.0M   0% /mnt/addons
tmpfs           1.0M     0  1.0M   0% /mnt/rootshare
/dev/md1p1      7.3T  5.7T  1.7T  78% /mnt/disk1
/dev/md2p1      7.3T  5.5T  1.8T  76% /mnt/disk2
/dev/md3p1      7.3T  5.5T  1.9T  75% /mnt/disk3
/dev/md4p1      7.3T  5.4T  1.9T  75% /mnt/disk4
/dev/md5p1      7.3T  5.5T  1.9T  76% /mnt/disk5
/dev/md6p1      7.3T  5.4T  1.9T  74% /mnt/disk6
/dev/md7p1      7.3T  6.0T  1.4T  82% /mnt/disk7
/dev/md8p1      7.3T  5.5T  1.9T  75% /mnt/disk8
/dev/md9p1      7.3T  2.5T  4.9T  34% /mnt/disk9
/dev/md10p1     3.7T  1.9T  1.9T  51% /mnt/disk10
/dev/md11p1     3.7T  1.9T  1.8T  51% /mnt/disk11
/dev/md12p1     3.7T  1.9T  1.9T  51% /mnt/disk12
/dev/md13p1     3.7T  1.9T  1.8T  51% /mnt/disk13
/dev/md14p1     3.7T  1.9T  1.9T  51% /mnt/disk14
/dev/md15p1     3.7T  2.0T  1.8T  53% /mnt/disk15
/dev/md16p1     3.7T  2.6T  1.1T  70% /mnt/disk16
/dev/md17p1     3.7T  2.6T  1.1T  71% /mnt/disk17
/dev/md18p1     3.7T  2.7T 1011G  73% /mnt/disk18
/dev/md19p1     3.7T  2.5T  1.2T  69% /mnt/disk19
/dev/md20p1     3.7T  2.7T  1.1T  72% /mnt/disk20
/dev/md21p1     7.3T  5.3T  2.1T  72% /mnt/disk21
/dev/md22p1     7.3T  4.9T  2.5T  67% /mnt/disk22
/dev/nvme1n1p1  932G  315G  616G  34% /mnt/appdata-nvme
/dev/nvme2n1p1  932G  883G   48G  95% /mnt/backup-nvme
/dev/nvme3n1p1  1.9T   16G  1.9T   1% /mnt/data-nvme
/dev/nvme0n1p1  932G  3.2G  927G   1% /mnt/transcode-nvme
shfs            121T   81T   40T  68% /mnt/user0
shfs            121T   81T   40T  68% /mnt/user
/dev/loop2      100G   25G   74G  25% /var/lib/docker
/dev/loop3      1.0G  4.1M  905M   1% /etc/libvirt

 

Edited by SNDS

  • Author

Why are there files directly in that folder from the backup AND separate backup job folders?

 

However, the debug log is telling me: "PHP-ERROR occured! 2 / mkdir(): No space left on device", so please check storage.

hi, I just noticed that external volume backed up only as 'symlink' and there is no data at all, I am doing something wrong?
 

image.png

image.png

image.png

Edited by kronox

  • Author

Then theres something wrong in that path. The plugin doesnt use symlinks at all. Maybe you use symlinks there to redirect the data somewhere else?

56 minutes ago, KluthR said:

Then theres something wrong in that path. The plugin doesnt use symlinks at all. Maybe you use symlinks there to redirect the data somewhere else?

It's probably an exclusive share in which case the root of it is a symlink, it's a standard unraid feature

Edited by Kilrah

changed mapping to container from /mnt/user/gitea/ to /mnt/cache/gitea/ now it is ok, not sure if thats possible but would be nice to see some warning that it is exclusive share and it is mapped via /user/, by accident noticed, if that would be real backup requiring situation would be in trouble, maybe others also having same config issue and some warning would come in handy

Edited by kronox

On 1/10/2025 at 9:19 PM, Kilrah said:

You must select the "backup-2" folder, NOT the individual backup. Next step will list the available backups to restore from.

Thanks so much for this. I was tearing my hair out trying to understand what I was doing wrong!

Can anyone explain why I'm getting old apps appearing in the backup folder?

eg my-binhex-get-iplayer.xml.bak or my-Tixati.xml

 

I removed get-iplayer years ago and there's no appdata folder for it any more!

 

Thanks.

That's the backup of the templates. They stay there until you go to Apps->Previous Apps and select/delete what you don't want anymore. The .baks were made by old unraid versions and you'll have to remove them from the flash drive manually. 

Perfect, thanks for your help.

On 3/27/2024 at 11:10 PM, tmor2 said:

Every one of my back ups fail. I use setting stop all containers, backup then restart. The issue is mariadb app - the backup fails, and as a result, the entire backup fails (eventhough the backup of NO other apps during the process fails)

 

How can TAR creation fail???

 

How is this error solved?

 

Thanks.

 

Here is error message:

[27.03.2024 18:32:53][ℹ️][mariadb] Should NOT backup external volumes, sanitizing them...
[27.03.2024 18:32:53][ℹ️][mariadb] Calculated volumes to back up: /mnt/user/appdata/mariadb
[27.03.2024 18:32:53][ℹ️][mariadb] Backing up mariadb...
[27.03.2024 18:35:51][][mariadb] tar creation failed! Tar said: tar: /mnt/user/appdata/mariadb/databases/75813e901614.err: File shrank by 880862549 bytes; padding with zeros

 

Were you able to resolve this? I've got a similar error with mariadb

 

Debug log: 154b13a5-05b8-440f-a349-7a86ef175b70

If dev or anyone else can help too would be greatly appreciated!

Edited by unraid20

So I have lost my appdata due to some silly choices changing my cache to zfs forgetting to back it up and then it becoming corrupted. I have some old backups but tried to use the restore but it errors out saying it is invalid. I have seen you can extract the files but I am a little confused whether just to extract the tar.gz or do I need to also do something with the XML also I guess the .bak is just  a backup do I need to do anything with those. Any help is appreciated

I have been getting tar verification failed errors for 3 containers.  Its the same 3 each time.  CrashplanPro, Handbrake and Doublecommander.  I have verified that the 3 directories each have stuff in them, they are not empty directories.  And I have excluded any external directories.  Any help would be appreciated.

 

Debug log: 64b0d6e2-0f0b-43d9-8519-d32c86cecd72

 

[24.02.2025 07:43:53][ℹ️][Main] 👋 WELCOME TO APPDATA.BACKUP!! :D
[24.02.2025 07:43:53][ℹ️][Main] Backing up from: /mnt/user/appdata
[24.02.2025 07:43:53][ℹ️][Main] Backing up to: /mnt/user/backups/backup_appdata/ab_20250224_074353
[24.02.2025 07:43:53][ℹ️][Main] Selected containers: CrashPlanPRO, HandBrake, JDownloader2, Maintainerr, bazarr, binhex-privoxyvpn, binhex-qbittorrentvpn, binhex-sabnzbdvpn, bitwarden, bookstack, doublecommander, mariadb, overseerr, phpmyadmin, plex, psitransfer, radarr, sonarr, swag, tautulli, tdarr
.
[24.02.2025 07:44:07][ℹ️][doublecommander] Stopping doublecommander... done! (took 7 seconds)
[24.02.2025 07:44:14][ℹ️][doublecommander] Should NOT backup external volumes, sanitizing them...
[24.02.2025 07:44:14][ℹ️][doublecommander] Calculated volumes to back up: /mnt/user/appdata/doublecommander
[24.02.2025 07:44:14][ℹ️][doublecommander] Backing up doublecommander...
[24.02.2025 07:44:14][ℹ️][doublecommander] Backup created without issues (took 00:00:00 (hours:mins:secs))
[24.02.2025 07:44:14][ℹ️][doublecommander] Verifying backup...
[24.02.2025 07:44:14][][doublecommander] tar verification failed! Tar said: tar: /mnt/user/appdata/doublecommander: Not found in archive; tar: Exiting with failure status due to previous errors
[24.02.2025 07:44:15][ℹ️][doublecommander] Starting doublecommander... (try #1) done!
.
[24.02.2025 08:00:28][ℹ️][HandBrake] Stopping HandBrake... done! (took 2 seconds)
[24.02.2025 08:00:30][ℹ️][HandBrake] Should NOT backup external volumes, sanitizing them...
[24.02.2025 08:00:30][ℹ️][HandBrake] Calculated volumes to back up: /mnt/user/appdata/HandBrake
[24.02.2025 08:00:30][ℹ️][HandBrake] Backing up HandBrake...
[24.02.2025 08:00:30][ℹ️][HandBrake] Backup created without issues (took 00:00:00 (hours:mins:secs))
[24.02.2025 08:00:30][ℹ️][HandBrake] Verifying backup...
[24.02.2025 08:00:30][][HandBrake] tar verification failed! Tar said: tar: /mnt/user/appdata/HandBrake: Not found in archive; tar: Exiting with failure status due to previous errors
[24.02.2025 08:00:32][ℹ️][HandBrake] Starting HandBrake... (try #1) done!
[24.02.2025 08:00:34][ℹ️][CrashPlanPRO] Stopping CrashPlanPRO... done! (took 8 seconds)
[24.02.2025 08:00:42][ℹ️][CrashPlanPRO] Should NOT backup external volumes, sanitizing them...
[24.02.2025 08:00:42][ℹ️][CrashPlanPRO] Calculated volumes to back up: /mnt/user/appdata/CrashPlanPRO
[24.02.2025 08:00:42][ℹ️][CrashPlanPRO] Backing up CrashPlanPRO...
[24.02.2025 08:00:42][ℹ️][CrashPlanPRO] Backup created without issues (took 00:00:00 (hours:mins:secs))
[24.02.2025 08:00:42][ℹ️][CrashPlanPRO] Verifying backup...
[24.02.2025 08:00:42][][CrashPlanPRO] tar verification failed! Tar said: tar: /mnt/user/appdata/CrashPlanPRO: Not found in archive; tar: Exiting with failure status due to previous errors
[24.02.2025 08:00:44][ℹ️][CrashPlanPRO] Starting CrashPlanPRO... (try #1) done!
.
[24.02.2025 08:01:32][ℹ️][Main] VM meta backup enabled! Backing up...
[24.02.2025 08:01:32][ℹ️][Main] Done!
[24.02.2025 08:01:32][⚠️][Main] An error occurred during backup! RETENTION WILL NOT BE CHECKED! Please review the log. If you need further assistance, ask in the support forum.
[24.02.2025 08:01:32][ℹ️][Main] DONE! Thanks for using this plugin and have a safe day ;)
[24.02.2025 08:01:32][ℹ️][Main] ❤️

 

Edited by mattekure

This plugin is great. Super useful. Thank you for making and supporting it. I have a question about the warning generated for containers that don't have any local storage, like glances and dozzle. Appdata Backup gives the following warning when there's no local storage to back up:

 

Event: Appdata Backup
Subject: [AppdataBackup] Warning!
Description: Please check the backup log!
Importance: warning

dozzle does not have any volume to back up! Skipping. Please consider ignoring this container.

I don't want to ignore or skip the container because I still want Appdata Backup to update the container during the backup run. Is there a good way to configure things so this warning isn't generated, but without skipping the container so it still gets updated?

 

Thank you!

I only started using appdata backup recently and I'm finding all of my backup sources seem to be invalid. I am not seeing errors in the log. Is this common? Any suggestions for troubleshooting?

 

On 1/14/2025 at 9:20 PM, Kilrah said:

You're supposed to map containers to /mnt/user/appdata and configure the appdata share to reside on the "dockers" pool. 

Doesn't using cache help performance though?

  • Author
On 2/26/2025 at 1:12 AM, grigsby said:

I don't want to ignore or skip the container because I still want Appdata Backup to update the container

Enable „skip backup“ in container advanced settings

 

5 hours ago, gumbopot said:

Any suggestions for troubleshooting?

Submit a debug log

1 hour ago, KluthR said:

Enable „skip backup“ in container advanced settings

 

Submit a debug log

Log id: 63c0e767-8197-4aa7-9a07-7d78a5d6345e

2 hours ago, Hitcher said:

Doesn't using cache help performance though?

Yes in some cases but so does making the appdata share exclusive, which is now the preferred solution since it was introduced.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.