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

2 hours ago, TheJoJo said:

As of this past month, my backups seem to be failing. No issues prior to now. Debug Log saying "No space left on device" but my array has about 500GB free, so I'm not sure where that's coming from. Any insight is appreciated!

The backup is .

You can find the normal log at: /tmp/appdata.backup/ab.log
You can find the debug  log at: /tmp/appdata.backup/ab.debug.log

You are currently viewing the debug log!

[02.04.2026 13:38:08][ℹ️][Main] 👋 WELCOME TO APPDATA.BACKUP!! :D
[02.04.2026 13:38:08][debug][Main] plugin-version: 2026.03.13
[02.04.2026 13:38:08][debug][Main] unraid-version: Array
(
[version] => 7.0.1
)

[02.04.2026 13:38:08][debug][Main] Not executing script: Not set!
[02.04.2026 13:38:08][ℹ️][Main] Backing up from: /mnt/user/appdata, /mnt/cache/appdata
[02.04.2026 13:38:08][ℹ️][Main] Backing up to: /mnt/user/backups/app_data_backups/ab_20260402_133808
[02.04.2026 13:38:08][debug][Main] PHP-ERROR occured! 2 / mkdir(): No space left on device /usr/local/emhttp/plugins/appdata.backup/scripts/backup.php:80
[02.04.2026 13:38:08][][Main] Cannot create destination folder!
[02.04.2026 13:38:08][ℹ️][Main] Checking retention...
[02.04.2026 13:38:08][debug][Main] toKeep after slicing:
Array
(
[0] => /mnt/user/backups/app_data_backups/ab_20260325_020001-failed
[1] => /mnt/user/backups/app_data_backups/ab_20260324_020001
[2] => /mnt/user/backups/app_data_backups/ab_20260323_020001
)

[02.04.2026 13:38:08][debug][Main] Delete backups older than 20260326_133808
[02.04.2026 13:38:08][debug][Main] Cannot create date from ab_20260325_020001-failed
[02.04.2026 13:38:08][debug][Main] Discarding /mnt/user/backups/app_data_backups/ab_20260324_020001, because its newer or already in toKeep
[02.04.2026 13:38:08][debug][Main] Discarding /mnt/user/backups/app_data_backups/ab_20260323_020001, because its newer or already in toKeep
[02.04.2026 13:38:08][debug][Main] Resulting toKeep: /mnt/user/backups/app_data_backups/ab_20260325_020001-failed, /mnt/user/backups/app_data_backups/ab_20260324_020001, /mnt/user/backups/app_data_backups/ab_20260323_020001, /mnt/user/backups/app_data_backups/ab_20260325_020001-failed
[02.04.2026 13:38:08][debug][Main] Resulting deletion list:
[02.04.2026 13:38:08][ℹ️][Main] DONE! Thanks for using this plugin and have a safe day ;)
[02.04.2026 13:38:08][ℹ️][Main] ❤️
[02.04.2026 13:38:09][debug][Main] PHP-ERROR occured! 2 / copy(/mnt/user/backups/app_data_backups/ab_20260402_133808/backup.log): Failed to open stream: No such file or directory /usr/local/emhttp/plugins/appdata.backup/scripts/backup.php:384
[02.04.2026 13:38:09][debug][Main] PHP-ERROR occured! 2 / copy(/mnt/user/backups/app_data_backups/ab_20260402_133808/config.json): Failed to open stream: No such file or directory /usr/local/emhttp/plugins/appdata.backup/scripts/backup.php:385
[02.04.2026 13:38:09][debug][Main] Not executing script: Not set!

Solved in the Unraid Discord! Thanks. Explanation below in case anyone comes across this looking for the solution:

image.png

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

14 hours ago, TheJoJo said:

Debug Log saying "No space left on device" but my array has about 500GB free, so I'm not sure where that's coming from.

Check min free space setting on your backups share.

I was surprised to discover, after upgraded to 7.3 and internal boot, "flash backup" still works. No reconfiguration necessary. Thank you!

  • 2 weeks later...

hi guys, i recently discovered that as of december 2025 my plugin never run again.
there are no files in /tmp/appdata.backup
just run a manual backup and it ran fine so its probably my custom cron that is silently failing:
0 10 * * 4#3

it was suppose to run every 3rd (#3 )Thursday (day 4) of the month at 10:00AM. Its probably the hash that is breaking this. Do I need a different format for unraid?

1 hour ago, RezzZ said:

it was suppose to run every 3rd (#3 )Thursday (day 4) of the month at 10:00AM. Its probably the hash that is breaking this. Do I need a different format for unraid?

https://crontab.guru/ says it's invalid too.

On 4/16/2026 at 2:25 PM, Kilrah said:

https://crontab.guru/ says it's invalid too.

yes I saw that too.
wanted to try this next but its not allowed:
0 10 22-28 * * [[ $(date +%u) -eq 4 ]]

input field seems to be limited by nr of characters.
Thought I'll just do it once every 4 weeks then but even that seems impossibe in cron.

update: I looked at the cron line created when scheduling inside the plugin, I now set it up running as a user script using:
0 10 22-28 * * [[ $(date +%u) -eq 4 ]]
I switched to 4th Thursday as the 3rd aleady passed :). Fingers crossed

Edited by RezzZ

38 minutes ago, RezzZ said:

Thought I'll just do it once every 4 weeks then but even that seems impossibe in cron.

You'd use monthly...

5 minutes ago, Kilrah said:

You'd use monthly...

using monthly it will be a different day every month. thats really bad

3 hours ago, RezzZ said:

thats really bad

I mean to me what would be "really bad" is to only backup appdata once a month 😁 for me it's nightly

Hi

I’m trying to exclude the relevant Plex folders from the appdata backup, but the backup is still taking a long time and growing very large. I’ve added entries to the “Global exclusion list” (see below), yet it still spends ages on Plex and the file size keeps increasing. I suspect the path is incorrect, but I’m not sure how to identify the correct one. Can anyone advise?

mnt/User/appdata/binhex-plex/Plex Media Server/Cache

mnt/User/appdata/binhex-plex/Plex Media Server/Media

mnt/User/appdata/binhex-plex/Plex Media Server/Metadata

21 hours ago, takkischitt said:

mnt/User/appdata/binhex-plex/Plex Media Server/Cache

mnt/User/appdata/binhex-plex/Plex Media Server/Media

mnt/User/appdata/binhex-plex/Plex Media Server/Metadata

User should be user, not capitalised.

Edited by Kilrah

11 hours ago, takkischitt said:

Hi

I’m trying to exclude the relevant Plex folders from the appdata backup, but the backup is still taking a long time and growing very large. I’ve added entries to the “Global exclusion list” (see below), yet it still spends ages on Plex and the file size keeps increasing. I suspect the path is incorrect, but I’m not sure how to identify the correct one. Can anyone advise?

mnt/User/appdata/binhex-plex/Plex Media Server/Cache

mnt/User/appdata/binhex-plex/Plex Media Server/Media

mnt/User/appdata/binhex-plex/Plex Media Server/Metadata

Do any of your paths loop into one another? I had a file in my Plex Library and loading that file into the paths to hold media files will cause a loop that is purpetual and will fill your log file in minutes.

On 4/27/2026 at 1:00 PM, Kilrah said:

User should be user, not capitalised.

This fixed it! Thank you!

So I got the plugin setup with order for the containers to be started after backup but it does not seem to work as my VPN container should start first and then the others but timing is off as the others that depend on it start up either before or same time.

1 minute ago, nekromantik said:

So I got the plugin setup with order for the containers to be started after backup but it does not seem to work as my VPN container should start first and then the others but timing is off as the others that depend on it start up either before or same time.

Did you group the containers that should be together and set order for that group?

5 minutes ago, Kilrah said:

Did you group the containers that should be together and set order for that group?

How do you group them? i see no settings for groups in the appdata backup settings.

Only see startup order.

Expand container settings, enter a group name, apply, then select the group on any other container that needs to be part of it, then you have a separate block on the right to order them.

image.png

I have a container which I recently transitioned to being managed/run via docker compose (specifically, a dockhand client running on another host) rather than the Unraid Community Apps template.

Whenever the container is stopped/started, for example for app data backup, or for auto update applications (side note: forgot I had this and turned off for all docker containers) it restarts an older version of the container: namely a different container build, not routing the container through gluetun, etc.

I deleted the template in /boot/config/plugins/dockerMan/templates-user/ and I am hoping this fixes it. I had already disabled the container from being backed up but maybe because gluetun was backed up via app data backup, it still stopped and started the container in question. Basically I want to make sure if Unraid/the plugin ever stops this container, the newer version managed by compose (with all its variables, network, etc) is setup. Any advice?

TLDR: Migrated qBittorrent from Unraid Community Apps to Docker Compose (managed by Dockhand on a separate host). Unraid's Appdata Backup plugin keeps restarting the old version of the container.

32 minutes ago, Kilrah said:

Expand container settings, enter a group name, apply, then select the group on any other container that needs to be part of it, then you have a separate block on the right to order them.

image.png

thanks

5 hours ago, 54lzy said:

it restarts an older version of the container

It can't start something that isn't there, so that suggests you didn't remove the old container before moving to compose

2 hours ago, Kilrah said:

It can't start something that isn't there, so that suggests you didn't remove the old container before moving to compose

Believe I did. Also I believe if you try and start a docker compose stack where the container name is the same as a created but stopped container, it will give an error.

My plugin has been working for a couple of years, but recently it's not been working right. I haven't made any changes to any of the settings. I don't know if something changed with an update, or if something happened with my dockers, but the last few backups the plugin has made ended up with lots of errors about the dockers not restarting. I came home from work today and had another dozen emails about the dockers not starting. HOWEVER, when I checked, all the dockers were started fine. Checking the logs and the debug logs, it appears they're starting, just not as fast as the plugin would like.

Is there a way to set a longer delay before it gives up and throws an error?

Attempting restore of plex and the restore is not completing. 2 hours and stuck on the file.

Canceled the restore and get the following

[08.05.2026 13:29:38][ℹ️][Main] 👋 WELCOME TO APPDATA.BACKUP (in restore mode)!! :D
[08.05.2026 13:29:38][debug][Main] plugin-version: 2026.03.13
[08.05.2026 13:29:38][debug][Main] unraid-version: Array
(
[version] => 7.2.5
)

[08.05.2026 13:29:38][debug][Main] Array
(
[0] => /usr/local/emhttp/plugins/appdata.backup/scripts/restore.php
[1] => {"restoreSource":"\/mnt\/remotes\/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups\/","customRestoreDestination":"","restoreBackupList":"\/mnt\/remotes\/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups\/ab_20260503_000020","restoreItem":{"config":"on","vmMeta":"on","templates":{"my-CasaDePLaya.xml":"on"},"containers":{"CasaDePlaya.tar.gz":"on"}},"csrf_token":"38BC5670F95653A3","action":"startRestore"}
)

[08.05.2026 13:29:38][debug][Main] Array
(
[restoreSource] => /mnt/remotes/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups/
[customRestoreDestination] =>
[restoreBackupList] => /mnt/remotes/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups/ab_20260503_000020
[restoreItem] => Array
(
[config] => on
[vmMeta] => on
[templates] => Array
(
[my-CasaDePLaya.xml] => on
)

[containers] => Array
(
[CasaDePlaya.tar.gz] => on
)

)

[csrf_token] => 38BC5670F95653A3
[action] => startRestore
)

[08.05.2026 13:29:38][ℹ️][Main] Settings restored!
[08.05.2026 13:29:38][ℹ️][Main] Template 'my-CasaDePLaya.xml' restored!
[08.05.2026 13:29:38][ℹ️][Main] Restoring CasaDePlaya.tar.gz
[08.05.2026 13:29:38][debug][Main] Final tar command: tar -C '/' -x -f '/mnt/remotes/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups/ab_20260503_000020/CasaDePlaya.tar.gz' -z
[08.05.2026 14:26:29][debug][Main] Tar out: tar: Removing leading `/' from member names
[08.05.2026 14:26:29][][Main] restore failed! Tar said: tar: Removing leading `/' from member names
[08.05.2026 14:26:29][ℹ️][Main] Restore complete!

root@CRATER:~# cat /tmp/appdata.backup/ab.debug.log
[08.05.2026 13:29:38][ℹ️][Main] 👋 WELCOME TO APPDATA.BACKUP (in restore mode)!! :D
[08.05.2026 13:29:38][debug][Main] plugin-version: 2026.03.13
[08.05.2026 13:29:38][debug][Main] unraid-version: Array
(
[version] => 7.2.5
)

[08.05.2026 13:29:38][debug][Main] Array
(
[0] => /usr/local/emhttp/plugins/appdata.backup/scripts/restore.php
[1] => {"restoreSource":"\/mnt\/remotes\/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups\/","customRestoreDestination":"","restoreBackupList":"\/mnt\/remotes\/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups\/ab_20260503_000020","restoreItem":{"config":"on","vmMeta":"on","templates":{"my-CasaDePLaya.xml":"on"},"containers":{"CasaDePlaya.tar.gz":"on"}},"csrf_token":"38BC5670F95653A3","action":"startRestore"}
)

[08.05.2026 13:29:38][debug][Main] Array
(
[restoreSource] => /mnt/remotes/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups/
[customRestoreDestination] =>
[restoreBackupList] => /mnt/remotes/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups/ab_20260503_000020
[restoreItem] => Array
(
[config] => on
[vmMeta] => on
[templates] => Array
(
[my-CasaDePLaya.xml] => on
)

[containers] => Array
(
[CasaDePlaya.tar.gz] => on
)

)

[csrf_token] => 38BC5670F95653A3
[action] => startRestore
)

[08.05.2026 13:29:38][ℹ️][Main] Settings restored!
[08.05.2026 13:29:38][ℹ️][Main] Template 'my-CasaDePLaya.xml' restored!
[08.05.2026 13:29:38][ℹ️][Main] Restoring CasaDePlaya.tar.gz
[08.05.2026 13:29:38][debug][Main] Final tar command: tar -C '/' -x -f '/mnt/remotes/CASITAFS.DAVISCLAN.INTERNAL_UnRaid_backups/ab_20260503_000020/CasaDePlaya.tar.gz' -z
root@CRATER:~#

Edited by Taipan603
Update logs

I would like to request a 'feature' request, more of a settings tweak request. That you can limit the error messages being sent to just 1 per backup. If I have new containers added that don't have a volume, I am getting 'error' messages for each one, so for example, recently I installed Nextcloud AIO, with its internal multiple container system. Today's backup, I got 6 notification messages sent to my phone.

[10.05.2026 07:20:00][][nextcloud-aio-borgbackup] 'nextcloud_aio_backup_cache' does NOT exist! Please check your mappings! Skipping it for now.
[10.05.2026 07:20:06][][nextcloud-aio-borgbackup] 'nextcloud_aio_mastercontainer' does NOT exist! Please check your mappings! Skipping it for now.
[10.05.2026 07:20:12][][nextcloud-aio-borgbackup] 'nextcloud_aio_elasticsearch' does NOT exist! Please check your mappings! Skipping it for now.
[10.05.2026 07:20:17][][nextcloud-aio-borgbackup] 'nextcloud_aio_redis' does NOT exist! Please check your mappings! Skipping it for now.
[10.05.2026 07:20:30][][nextcloud-aio-clamav] 'nextcloud_aio_clamav' does NOT exist! Please check your mappings! Skipping it for now.
[10.05.2026 07:20:37][][nextcloud-aio-onlyoffice] 'nextcloud_aio_onlyoffice' does NOT exist! Please check your mappings! Skipping it for now.

Although I think they should probably be 'warnings' instead of errors, my request is that you only get 1 error notification message per backup, to reduce the spam. Thanks for the plugin.

I have changed the scheduling in the WebGUI to daily 1 pm. An overview of all cron jobs with "crontab -l" shows that this change has no effect.

But backup is still running at 2 am, 14 pm, and 18 pm.

How can I make the changes I made in WebuGUI take effect?

image.png

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.