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.

***OFFICIAL GUIDE*** Restoring your Docker Applications in a New Image File

Featured Replies

For those of you finding this (like me) in 2023. 

Go to your docker tab in unraid. then top right of the page click the slider to change to advanced instead of basic. 

under each docker listing you should see Force Update which does what it says on the tin. rebuilds from scratch using the latest images etc. 

Useful if like me you have some containers that dont show updates that are available.

  • Replies 94
  • Views 109.6k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • For those of you finding this (like me) in 2023.  Go to your docker tab in unraid. then top right of the page click the slider to change to advanced instead of basic.  under each docker list

  • rpmalouin
    rpmalouin

    So 8 years later this saved me after a power failure, lost all my docker containers. Who knew it was so EASY restore them  not me but I do now.

  • On the flash drive, edit this file: /config/docker.cfg. Remove the last line that's causing problems: DOCKER_OPTS="--runtime=nvidia"

Posted Images

  • Community Expert
2 hours ago, Driden said:

Useful if like me you have some containers that dont show updates that are available.

Install the Docker Update Patch from CA, this is due to changes on Docker side and isn't related to the topic.

  • 2 weeks later...
On 2/5/2023 at 1:12 PM, Kilrah said:

Install the Docker Update Patch from CA, this is due to changes on Docker side and isn't related to the topic.

no idea what this means sorry. 

 

The topic was "Should you wish to recreate your Docker virtual disk image from scratch, but retain your application data to avoid requiring reconfiguration for certain apps, the process is simple."

 

but the info was out of date so i added an alternative current available method. 

 

What would the Docker update patch from CA do?

 

  • Community Expert

It fixes the currently common problem of some containers not showing updates and I understood the last sentence as being related to that, might have misunderstood this situation being different given the number of people who have come with the above issue in the past couple of weeks.

Ah ok understood. I am not sure how the update path thing works. I have a few containers that never show an update being available so just assumed they dont publish updates correctly or something like that. some of my containers are not installed from Apps so not sure if that makes a difference. 

Either way i think the the force rebuild option is useful to know about for people as i assume, like me, some users might not have the advanced option enabled.

  • Community Expert
29 minutes ago, Driden said:

some of my containers are not installed from Apps so not sure if that makes a difference. 

Yeah it does, the update notification/status check works by keeping a list of the image versions for installed containers and comparing to that, but that only tracks what was installed via templates.

On 2/17/2023 at 1:06 PM, Kilrah said:

Yeah it does, the update notification/status check works by keeping a list of the image versions for installed containers and comparing to that, but that only tracks what was installed via templates.

i will have to dedicate some time to learning how the templates work so i can add some of the ones missing into the community apps area. 

im sure others would find them useful too. 

 

  • 3 months later...

I made the mistake of following these instructions thinking it would restore my containers after they somehow disappeared. Sure, they are back, but if you are reading this thinking these instructions will put things back to where they were, I think you might be dissapointed. Custom variables, specific settings in the container, custom networks etc. It all seems to be back to defaults forcing me to have to remember how I had previously setup my reverse proxy, SWAG settings etc. Sigh....

Edited by paulbram

  • Community Expert

The whole point is to restore everythig with your settings... Previous Apps in CA should be all you need.

Obviously that assumes the templates are still on the flash drive, if you say your containers "disappeared" flash corruption and those being lost could be the cause so then you're SOL indeed...

Edited by Kilrah

Currently custom networks are only kept in the image, so yes, you will need to redo the custom networks BEFORE you restore the Previous Apps that are looking for them. Custom variables should be in the templates, and so should container specific changes.

 

If, however, you don't have the apps set up properly so all their appdata is stored external to the image, you will lose those settings. Docker containers are supposed to be set up so all customization is done to mapped paths outside the image.

On 6/8/2023 at 7:43 AM, JonathanM said:

Currently custom networks are only kept in the image, so yes, you will need to redo the custom networks BEFORE you restore the Previous Apps that are looking for them. Custom variables should be in the templates, and so should container specific changes.

 

If, however, you don't have the apps set up properly so all their appdata is stored external to the image, you will lose those settings. Docker containers are supposed to be set up so all customization is done to mapped paths outside the image.

 

How can I confirm if I have things stored outside the image properly? For some reason, my SWAG docker container wasn't listed in the user templates, even though everything else was. As a result, all my reverse proxy stuff is broken even though it seems my actual containers are working. I wonder if it's all related to the missing custom network.

4 minutes ago, paulbram said:

For some reason, my SWAG docker container wasn't listed in the user templates

Are you talking about previous apps or something else?

  • 3 weeks later...

So 8 years later this saved me after a power failure, lost all my docker containers. Who knew it was so EASY restore them :) not me but I do now.

  • 1 year later...

Hi, I had the issue that my Minecraft installation was blowing up my Docker Image Size until I recogniced that there are some tmp file causing the increase.

 

Unfortunatley I have always extended the docker image, now up to 330GB causing running my Cache Drives Full.

 

After cleaning up the Container Size is now only 20GB.

 

Although it seems very easy to reduce the docker file by deleting the docker image and recreating it with a smaller size I have one question: I am technical, but not too technical and not an docker expert. I am running my Unraid since years so I am unsure if I  have done everything correct from the beginning. 

 

If I want to be on the safe side - is it enough to backup the docker image in case something goes wrong with the restore? Or docker image + appdata? or something else?

 

Best Regards,

Johannes

  • Community Expert

No need to backup docker.img, it is easily recreated from your templates.

 

Appdata backup, and your docker templates on your boot flash drive in config/plugins/dockerMan/templates-user

 

You must always have a current backup of flash for many reasons anyway.

 

https://docs.unraid.net/unraid-os/manual/docker-management/#re-create-the-docker-image-file

 

https://docs.unraid.net/unraid-os/manual/docker-management/#re-installing-docker-applications

 

https://docs.unraid.net/unraid-os/manual/docker-management/#docker-custom-networks

  • 3 months later...

I had a power issue and my ups didnt switch in time with the surge. System rebooted and parity checked and was fine. All drives are healthy.

But Docker failed to start.

image.png

i deleted the docker image and reenabled and still not working. i restored a full usb backup and still not working.

What can i do to fix the issue? (i have also purchased a new ups to avoid future issues).

thanks

rossiserver-diagnostics-20250524-1406.zip

On the flash drive, edit this file: /config/docker.cfg. Remove the last line that's causing problems:

DOCKER_OPTS="--runtime=nvidia"

Thanks Squid, i had done this (without stopping the docker) and wrecked my usb! i just did a restore and restored backup config, the docker issue was there and then i stopped docker, removed this line and docker is working. i am restoring my containers.

But i had added that line a couple of weeks ago to make the new GPU work with ollama. i had a couple of reboots since then without any issue until this power surge yesterday.

After reinstating my containers, everything seems to be working fine. i think i also have ollama using the gpu without this (as i had added a variable in ollama container)

thanks

Edited by Maximo101

  • 2 months later...

Could someone please give an update on how things work in 2025? This tutorial is TEN YEARS old. Reading all the comments, i'm still not able to say if deleting the docker.img is still recommended or not, we're missing a full update on this very important procedure. I can not proceed cleaning up my dockers without knowing the functional, recommended way in 2025.

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.