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.

7.2.4 - Docker UI (only) hangs and is unresponsive. Services work. PHP error in logs.

Featured Replies

Just started this morning. Everything seems to be working fine except when accessing the Docker tab of the webgui, it appears to load, but the Unraid loading spinner never goes away and the page is unresponsive. Docker itself and services that auto-started work. I can interact with the widget on the dashboard to start/stop/etc services. It's just Unraid's Docker UI tab that seems to be affected.

Untitled 2.png

The only thing I see that appears related is this in the phplog:

[04-Mar-2026 09:10:52 America/Chicago] PHP Fatal error:  Uncaught ValueError: Path cannot be empty in /usr/local/emhttp/plugins/dynamix.docker.manager/include/CreateDocker.php:182
Stack trace:
#0 /usr/local/emhttp/plugins/dynamix.docker.manager/include/CreateDocker.php(182): file_get_contents('')
#1 {main}
  thrown in /usr/local/emhttp/plugins/dynamix.docker.manager/include/CreateDocker.php on line 182

Problem is NOT fixed by reboot in safe mode.

mybox-safemode-diagnostics-20260304-0922.zip

  • Community Expert

Why did you decide to use a docker folder instead of default docker.img?

  • Community Expert

Try recreating the Docker folder as a Docker image, I've seen many strange issues with Docker folders.

  • 2 months later...

did you end up finding a fix for this? I am experiencing exactly the same issue and wondering if its specific to 7.2.4 or whether i should just upgrade to 7.2.5 in hopes of resolving this.

I resolved this just now.

The main cause of the issue is that I had two docker containers (qbittorrent, and sabnzbd) whose network stack relied on another container (gluetunvpn).
From what I can tell, the WebUI on the docker tab seems to wait for the containers to come back up when they are in "rebuilding..." status.

I found out that I had a few corrupt config files and xml files on USB (which I had transferred from a previous USB).
The corrupt files were:
root of usb flash drive\config\plugins\dynamix\dynamix.cfg
root of usb flash drive\config\plugins\dockerMan\userprefs.cfg
some of the xmls in:
root of usb flash drive/config/plugins/dockerMan/templates-user/

Luckily I had (older) backups of the top two files, the xml's I didn't have a recent copy of but I knew the port mappings etc, so I just let those get re-created after I deleted the corrupt ones.

With the help of claude I was able to get it functional again.


The process for me was:
use unraid terminal to stop all the docker containers from running.
get gluetunvpn container running

get those two network reliant containers running which involved:
re-creating a blank version of their xml user-template files

restoring the contents from an old copy I had from a backup (lucky I had these, i dont even know where they are generated from)

using the built-in rebuild scripts to re-create the containers to use the new xml files

Once gluetunvpn was started, and the two reliant containers were started successfully, I was able to use the Docker tab WebUI to update/start/re-configure all my other containers etc.
Hope this helps someone else.


Below is a summary I had claude do, take it with a grain of salt

# Unraid Docker Tab Recovery — 7.2.x
 
## Root Cause
Flash drive restore from a corrupted backup resulted in:
- Missing/corrupted XML user-template files for containers that use another container as their network stack (e.g. a VPN container like GluetunVPN)
- Without valid templates, affected containers showed `container:???` for their network
- The Docker tab would hang indefinitely waiting on those unresolvable container statuses
---
 
## Recovery Steps
 
### 1. Stop All Containers
From the Unraid terminal, stop everything so the Docker tab can attempt to load:
```bash
docker stop $(docker ps -q)
```
 
### 2. Start Your VPN Container First
If your containers use a VPN container (e.g. GluetunVPN) as their network stack, start it first and verify it connects successfully before proceeding:
```bash
docker start GluetunVPN
docker logs GluetunVPN --tail 20
```
Look for: `Initialization Sequence Completed`
 
### 3. Recreate Missing User Templates
Any containers whose XML templates are missing will fail to rebuild. Create blank files and populate from backup (adjust filenames to match your containers):
```bash
touch /boot/config/plugins/dockerMan/templates-user/my-container1.xml
touch /boot/config/plugins/dockerMan/templates-user/my-container2.xml
```
Edit each file with the backed-up XML contents:
```bash
nano /boot/config/plugins/dockerMan/templates-user/my-container1.xml
nano /boot/config/plugins/dockerMan/templates-user/my-container2.xml
```
 
### 4. Rebuild the Network-Dependent Containers
With the VPN container running and templates restored, rebuild the affected containers:
```bash
docker rm -f <container1> <container2>
/usr/local/emhttp/plugins/dynamix.docker.manager/scripts/rebuild_container <container1>
/usr/local/emhttp/plugins/dynamix.docker.manager/scripts/rebuild_container <container2>
```
 
### 5. Verify Docker Tab Loads
Refresh the Unraid WebUI Docker tab — it should now load without hanging.
 
### 6. Fix Any Remaining Container Issues
Run **Tools → Docker Safe New Perms** in the WebUI to fix any permission issues
caused by the flash restore. This resolved qBittorrent's WebUI not loading.
 
---
 
## Key Useful Terminal Commands
 
| Task | Command |
|------|---------|
| Stop all containers | `docker stop $(docker ps -q)` |
| Rebuild container from template | `/usr/local/emhttp/plugins/dynamix.docker.manager/scripts/rebuild_container <name>` |
| Restart php-fpm (fixes WebUI hangs) | `/etc/rc.d/rc.php-fpm restart` |
| Check for rogue php-fpm processes | `ps aux \| grep php-fpm` |
| View container logs | `docker logs <name> --tail 30` |
| Check container port mappings | `docker port <name>` |
| Check running processes inside container | `docker exec <name> ps aux` |
 
---
 
## Where User Templates Live
```
/boot/config/plugins/dockerMan/templates-user/
```
These XML files define how each container is created. **Back these up regularly** — 
they are the most critical files for recreating your Docker setup.
 
---
 
## Prevention / Backup Recommendations
 
1. **Back up templates-user folder to the array after any container changes:**
```bash
cp -r /boot/config/plugins/dockerMan/templates-user/ /mnt/user/appdata/unraid-template-backup/
```
 
2. **Use Unraid Connect** (Settings → Management Access) for automatic cloud flash backups
3. **Manual flash backup** after major changes: Main → Boot Device → Flash → Flash Backup
4. **Set autostart delays** on containers that depend on a VPN network stack (30-60 seconds) so the VPN container always connects before they try to attach to its network
---
 
## Container Start Order (Important)
Your VPN container **must** be running before any containers that use it as their network stack are started. If they start before the VPN container, they will show `container:???` and may cause the Docker tab to hang.
 
```bash
docker start <vpn-container>
sleep 15
docker start <container1> <container2>
```
 
Set autostart delays on network-dependent containers (30-60 seconds) in the Docker tab so the VPN container always comes up first on reboot.

I have the same issue and just fixed it by removing job with network container relation.

Edited by kusz

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.