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

does this app data not backup the actual appdata folder of say 500gb of files and the System Folder

as this only seems to backup the xml docker settings but not the actual app data folder

and is there a a backup to backup the System folder for the docker.img and the libvirt.img

as i have a corrupted libvirt.img and want to backup the vdisks of the vms as well.. but i noticed the appdata backup doesnt actually backup the docker. img file or the appdata folder

  • Replies 2.2k
  • Views 364.3k
  • 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

10 hours ago, comet424 said:

does this app data not backup the actual appdata folder of say 500gb of files

Sure, that's what it's for. If it's not working for you you probably don't have a standard setup / share names and need to configure correctly.

10 hours ago, comet424 said:

and the System Folder

No. docker.img should not need backing up as it's supposed to not contain anything that can't be recreated automatically. Libvirt the important thing are the VM xml's which this plugin can backup. But VMs are not this plugin's focus, there's another plugin for VM backup.

21 hours ago, Kilrah said:

Says no space, so check drive utilization and the min free space setting for that share.

Thanks @Kilrah

I spotted that, but was unsure which share this relates to... I have a "/mnt/user/appdata backup" share which I created to store these backups, but it has plenty of space...

image.png

image.png

image.png

Edited by SliMat

18 minutes ago, SliMat said:

I have a "/mnt/user/appdata backup" share which I created to store these backups, but it has plenty of space...

As mentioned you have to check the min free space setting of that share, e.g. you may have 5TB free total on the array but if the min free space is set to 2TB and no single disk has more than 2TB free the share will appear as full.

4 minutes ago, Kilrah said:

As mentioned you have to check the min free space setting of that share, e.g. you may have 5TB free total on the array but if the min free space is set to 2TB and no single disk has more than 2TB free the share will appear as full.

Apologies - I just realised I was logged on to the wrong server, so the above readings are wrong... this is the server with this problem...

image.png

image.png

image.png

The minimum space is set to 390.5Gb and the share has 850Gb space... so should be OK, I think!

Incidentally, I checked the size of the backups and the folders are about 15Gb in size.

Edited by SliMat

Still missing the list of the free space of each drive from the main page...

I had a warning from unraid saying one of my disks was getting full, which was weird cos I should have had several TB of empty space on that disk.

Turns out it was because the appdata backups were taking up huge amounts of space.

I have it set to delete all backups older than 7 days, but I instead have several months worth of backups in the folder lol. I'm manually deleting them now, but is this a known issue and is there a fix?

3 hours ago, Nirin said:

I have it set to delete all backups older than 7 days, but I instead have several months worth of backups in the folder lol. I'm manually deleting them now, but is this a known issue and is there a fix?

Are they marked Failed? If so that's intentional, when backup fails old ones are not deleted to avoid losing all last non-failed backups over time.

22 hours ago, Kilrah said:

Still missing the list of the free space of each drive from the main page...

image.png

22 hours ago, Kilrah said:

Still missing the list of the free space of each drive from the main page...

33 minutes ago, SliMat said:

image.png

So there you go, no disk has more free space than your set minimum of 390.5GB, so there is no disk suitable for storing more data for this share. Adjust min free space.

@Kilrah couple questions i did get it to backup the appdata folder now..

i use /mnt/unraid_files/appdata that is the /mnt/user/appdata folder but that section where it has

/mnt/user/appdata

/mnt/cache/appdata

i added

/mnt/unraid_files/appdata

dunno why i needed to since it points to /mnt/user/appdata

so that backed that up

but i not seeing the vm xml backup.. as i wanna backup and restore all the vms in the Libvirt file... and can this appdata backup restore the vms xmls with a restore.. as i having issues the auto start no longer works on my vms so i wanna backup blow out the Libvirt file and restore the xml files i got like 30 vms so i didnt wanna do it manually....

but i least got the appdatas to backup now

so i tried the vm meta backup it backed it up i renamed the libvirt to oldlbvirt

i also stopped the vm service... i then restored the vm meta backup it didnt restore the vms

i then stopped service.. renamed the lib file then restarted.. then did the vm meta backup restore

still didnt restore the xml to fix if the lib file was corrupt.. as my autostarts wont work... is there someting i doing wrong its not updating the libvirt file from the restore meta

and also be nice to be able to select which vm backup meta to restore like the docker ones...

and the vmbackup plugin i installed it backed up the vms but it has no option to restore the vms or create the lib file either unless i doing something wrong.. just the vmbackup seems to backup no restore

Edited by comet424

i ended up rebooting unraid and when i checked vms the vms were back.. i guess the restore puts it /etc/libvirt/qemu location and a reboot restores the lib file?

but still didnt repair the problem the auto starts are checked yet wont start anymore just manual start works.. i was hoping it would have solved this problem

4 hours ago, comet424 said:

i having issues the auto start no longer works on my vms so i wanna backup blow out the Libvirt file and restore the xml files

That won't help. Make a new troubleshooting thread for that with any errors you get if you want support for it since it's off topic for here...

Hello,

just trying to clean things up a bit.. is it safe to delete those failed files? they are old from 2024

image.png

Hello everyone, hoping to get some help with a multi-mapping error

As far as I can tell, my other containers are backing up fine except my authentik appdata folder which is mapped to two containers authentik and authentik-worker

There was a recent update in folder structure to add a data subdirectory which works well but I think is causing issues on the backup side. I set some exclusions but I'm still getting errors.

Questions:

  1. What's the best way to solve this?

  2. In the authentik appdata folder there is also a database directory that holds Postgres data but doesn't show up in any of the configured paths. how do I ensure the entire folder is backed up? I assume it is a permissions thing but I am by no means an expert. just going off what I see when I look at the files on macOS


Please see my screenshots and log below

Thank you!


[21.01.2026 09:43:29][ℹ️][authentik-worker] Stopping authentik-worker... done! (took 1 seconds)
[21.01.2026 09:43:30][ℹ️][authentik-worker] Should NOT backup external volumes, sanitizing them...
[21.01.2026 09:43:30][ℹ️][authentik-worker] Calculated volumes to back up: /mnt/user/appdata/authentik/certs, /mnt/user/appdata/authentik/backups, /mnt/user/appdata/authentik/data/media
[21.01.2026 09:43:30][ℹ️][authentik-worker] Backing up authentik-worker...
[21.01.2026 09:43:30][ℹ️][authentik-worker] Backup created without issues (took 00:00:00 (hours:mins:secs))
[21.01.2026 09:43:30][ℹ️][authentik-worker] Verifying backup...
[21.01.2026 09:43:30][][authentik-worker] tar verification failed! Tar said: tar: Removing leading `/' from member names; tar: /mnt/user/appdata/authentik/data/media: Not found in archive; tar: Exiting with failure status due to previous errors
[21.01.2026 09:43:31][ℹ️][authentik-worker] Starting authentik-worker... (try #1) done!
[21.01.2026 09:43:33][ℹ️][authentik] Stopping authentik... done! (took 0 seconds)
[21.01.2026 09:43:33][ℹ️][authentik] '/mnt/user/appdata/authentik/data/media' is within mapped volume '/mnt/user/appdata/authentik/data'! Ignoring!
[21.01.2026 09:43:33][ℹ️][authentik] Should NOT backup external volumes, sanitizing them...
[21.01.2026 09:43:33][ℹ️][authentik] Calculated volumes to back up: /mnt/user/appdata/authentik/data, /mnt/user/appdata/authentik/templates
[21.01.2026 09:43:33][ℹ️][authentik] Backing up authentik...
[21.01.2026 09:43:33][ℹ️][authentik] Backup created without issues (took 00:00:00 (hours:mins:secs))
[21.01.2026 09:43:33][ℹ️][authentik] Verifying backup...
[21.01.2026 09:43:33][ℹ️][authentik] Verification ended without issues (took 00:00:00 (hours:mins:secs))

appdata-authentik.png

appdata-authentik-worker.png

authentik-folders.png

Edited by pilgrim
grammar

Question in "AppData Backup" plugin - Flash drive backup location.

Config:

Flash drive: /mnt/cache_nvme/backup_local/flash-drive-backup/

Backup destination: /mnt/cache_nvme/backup_local/appdata-backup/


But I can see the flash drive file in both the locations. Check the second and third screenshot.

What am I doing wrong ?

I backup these to Azure blob storage(which is pay as you go model), so I would like to avoid these duplicates. Hope the post makes sense.

Setup:
image.png

Appdata Backup Location:
image.png


Flash drive backup location:
image.png

Edited by PradeepChinna

On 11/18/2025 at 3:37 AM, JTVUS said:

Just to close the loop on my issue in case anyone else is having it: It does appear to be the update setting.

I apparently forgot to save the setting change last week, so the backup ran successfully this morning without automatically applying updates. When I changed the setting to automatically update and ran a manual backup, it had the same errors starting the Docker apps again. So I will just keep the auto-update setting off for now. Thanks all.


I was having a similar issue to you and before searching for a solution on this thread I decided to create a Post-run script. The script waits 5 mins then restarts any containers that use the container as their network. This seems to have "fixed" the issue for me, however, I don't have auto update enabled so I suppose I could just do what you did with the container grouping/restart order and omit the script. Maybe the script is worth a shot If you're still interested in enabling the auto update feature(and it's still not working).

If you'd like to try, make sure to save your script with Unix line breaks (In Notepad++ click Edit > EOL Conversion > Unix (EF)). Put the script somewhere that's accessible via the plugin and make it executable (Open terminal and run "chmod +x /mnt/user/path/to/script/script_name.sh"), then point to that script as a "Post-run script" in the plugin.


#!/bin/bash
# Some values from the plugin - might be useful to you for further customization
ACTION=$1     
DEST_PATH=$2  
SUCCESS=$3

# log results to file
LOG_FILE="/mnt/user/path/to/logs/log_name.log"

# Specify your gluetun container name here
NETWORK_NAME="GluetunVPN"
NETWORK_ID=$(docker inspect -f '{{.Id}}' "$NETWORK_NAME" 2>/dev/null)

mkdir -p "$(dirname "$LOG_FILE")"
{
    echo "--------------------------------------------------------------------------------------------------------------------------------"
    echo "Run Date: $(date '+%Y-%m-%d %H:%M:%S')"
    echo "Backup Status: $SUCCESS"
    
    # 5-minute delay
    sleep 300

	if [ -z "$NETWORK_ID" ]; then
        echo "Error: Could not find Network ID for $NETWORK_NAME. Is the name correct?"
    else
		# Get list of containers using your Gluetun container as thier network
		CONTAINER_LIST=$(docker inspect --format '{{if eq .HostConfig.NetworkMode "container:'$NETWORK_ID'"}}{{.Name}}{{end}}' $(docker ps -aq) 2>/dev/null | sed 's/\///' | grep .)

	    # Alternatively, get list of containers using any container as thier network - In this case setting and validating NETTWORK_NAME and NETWORK_ID are not needed.
	    # CONTAINER_LIST=$(docker inspect --format '{{if (ge (len .HostConfig.NetworkMode) 10)}}{{if eq (slice .HostConfig.NetworkMode 0 10) "container:"}}{{.Name}}{{end}}{{end}}' $(docker ps -aq) 2>/dev/null | sed 's/\///' | grep .)
	
	    if [ -z "$CONTAINER_LIST" ]; then
	        echo "No containers found using network: container:$NETWORK_NAME ($NETWORK_ID)"
	    else
	        for container in $CONTAINER_LIST
	        do
	            RUNNING=$(docker inspect -f '{{.State.Running}}' "$container" 2>/dev/null)
	            if [ "$RUNNING" == "true" ]; then
					# Only restart containers that are already running - You may want to change this
	                docker restart "$container" > /dev/null 2>&1
	                if [ $? -eq 0 ]; then
	                    echo "Successfully restarted $container."
	                else
	                    echo "Error: Failed to restart $container."
	                fi
	            else
	                echo "Skipping $container: Not currently running."
	            fi
	        done
	    fi
	fi

    echo "Process complete."

    # Only keep the last 500 lines of log - Can probably set this to a lower number
	tail -n 500 "$LOG_FILE" > "$LOG_FILE.tmp" && mv "$LOG_FILE.tmp" "$LOG_FILE"

} >> "$LOG_FILE" 2>&1

exit 0

Edited by atvking

Observed a strange error today during the scheduled backup. I looked through the thread and didnt see anything similar right off the bat.

[27.01.2026 05:35:02][debug][Main] PHP-ERROR occured! 8 / copy(): Write of 18874368 bytes failed with errno=28 No space left on device /usr/local/emhttp/plugins/appdata.backup/scripts/backup.php:191

Both my flashdrive and destination have an excess of 10GB, so I am not sure exactly which space it is talking about.


root@tower:/tmp/appdata.backup# df -h /usr/local/emhttp/
Filesystem      Size  Used Avail Use% Mounted on
overlay         7.8G  2.0G  5.8G  26% /usr

Any ideas? Thanks!

  • Author

Check the debug log at that line and show what it was trying to do right before it.

Hi all,

My cache SSD failed and I replaced it.

I'm trying to restore my Appdata but I just realised all my back ups have "-failed" against it.

image.png

But when I open the failed folder:

image.png

It actually has a lot of stuff in it.

Is there anyway to fix this "-failed" folder?

  • Author

Check the log files inside them. If nothing special caused the error, remove the -failed suffix and they should appear in the restore assistant.

33 minutes ago, KluthR said:

Check the log files inside them. If nothing special caused the error, remove the -failed suffix and they should appear in the restore assistant.

I checked the log and the only error was at the end:

[25.01.2026 04:18:51][ℹ️][Main] Backing up the flash drive.
[25.01.2026 04:19:56][ℹ️][Main] Flash backup created!
[25.01.2026 04:19:56][ℹ️][Main] VM meta backup enabled! Backing up...
[25.01.2026 04:19:56][ℹ️][Main] Done!
[25.01.2026 04:19:56][⚠️][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.
[25.01.2026 04:19:56][ℹ️][Main] DONE! Thanks for using this plugin and have a safe day ;)
[25.01.2026 04:19:56][ℹ️][Main] ❤️

4 minutes ago, KluthR said:

Thats a summary. Somewhere in between must be another error.

You are right.

[25.01.2026 04:04:42][ℹ️][tdarr] Verifying backup...
[25.01.2026 04:04:57][][tdarr] tar verification failed! Tar said: tar: Removing leading `/' from member names; mnt/user/appdata/tdarr/logs/Tdarr_Node_Log.txt: Mod time differs;

This is the only one. Not a major issue if I don't have that one.

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.