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.

Cannot update to the latest version of the plugin

Featured Replies

I have been trying to update to the latest version of the plugin, but it seems to hang during the update process (the update process hangs, not the server). I let it sit overnight hoping maybe it was just taking a long time, but this morning the update process was "still running in the background". When I rebooted, it was back to the old version of the update. I am attaching two versions of my diagnostics - one where the process is still "running"(eeyore-diagnostics-20250710-0749.zip) and one after my reboot (eeyore-diagnostics-20250710-0804.zip).

If you look at my past posts, this is not the first issue I have had with this plugin. In the past, after updating, it has always required me to reboot in order for the new plugin to work. I never got a fix for that issue. - https://forums.unraid.net/topic/188836-why-do-i-need-to-reboot-after-every-connect-plugin-update/
But now I cannot even update. :) (Not upset, just mildly annoyed).

eeyore-diagnostics-20250710-0749.zip eeyore-diagnostics-20250710-0804.zip

Solved by elibosley

can't connect since the last update of plugin (unraid 7.1.4)

i set to static, port xxx, or upnp, i just have sometimes a message that i can' get events from mothership ?

i try to add a uuid for sso, restart , nothing , infinite loading page

uc.png

Edited by Duc

It works now !

  • Author

Thanks, but I am still having the same issue from my initial post - it seems to hang on install:
Starting the Unraid API

plugin: updating: dynamix.unraid.net.plg

Executing hook script: pre_plugin_checks

plugin: downloading: dynamix.unraid.net-4.9.5-x86_64-1.txz ... done

Running on supported version 7.1.4

Backing up original files...

Backup complete.

Patching header logo if necessary...

Installing package...

Removing old package file: /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.4-x86_64-1.txz

Cleaning up existing node_modules directory...

Removing: /usr/local/unraid-api/node_modules

+==============================================================================

| Upgrading dynamix.unraid.net-4.9.4-x86_64-1 package using /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.5-x86_64-1.txz

+==============================================================================

Pre-installing package dynamix.unraid.net-4.9.5-x86_64-1...

Removing package: dynamix.unraid.net-4.9.4-x86_64-1-upgraded-2025-07-10,12:01:31

Verifying package dynamix.unraid.net-4.9.5-x86_64-1.txz.

Installing package dynamix.unraid.net-4.9.5-x86_64-1.txz:

PACKAGE DESCRIPTION:

# dynamix.unraid.net (Unraid API)

#

# Provides the Unraid API and Connect services for Unraid OS.

# This package enables remote management, monitoring, and access

# to Unraid servers through the Unraid Connect platform.

#

# Features include system monitoring, notifications, remote access,

# and integration with the Unraid Connect dashboard.

#

# Homepage: https://unraid.net/

Executing install script for dynamix.unraid.net-4.9.5-x86_64-1.txz.

Package dynamix.unraid.net-4.9.5-x86_64-1.txz installed.

Package dynamix.unraid.net-4.9.4-x86_64-1 upgraded with new package /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.5-x86_64-1.txz.

Starting Unraid Connect installation...

Setting up Unraid API...

Running post-installation verification...

Cleaning up node_modules archives that don't match current API version: 4.9.5

Current archive to keep: node_modules-for-v4.9.5.tar.xz

Cleanup completed.

Starting Unraid API service

If no additional messages appear within 30 seconds, it is safe to refresh the page.

Added bundled plugin unraid-api-plugin-connect

Starting Unraid API service...

Backup file not found at '/boot/config/plugins/dynamix.my.servers/node_modules-for-v4.9.5.tar.xz'. Skipping restore.

Starting flash backup service...

Starting the Unraid API
image.png
And as you can see, the CLOSE button never changes to DONE and:
image.png
I get this at the top. Same as with 4.9.4.

  • Community Expert

Thank you for flagging @Mantene . We'll investigate further within the team and see what we can figure out. I'm not sure why you're having many issues with upgrades, I'm really hoping we can solve this for you soon!

Same Issues for the Unaird Connect Plugin:
Executing install script for dynamix.unraid.net-4.9.5-x86_64-1.txz. Package dynamix.unraid.net-4.9.5-x86_64-1.txz installed. Package dynamix.unraid.net upgraded with new package /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.5-x86_64-1.txz. Starting Unraid Connect installation... Setting up Unraid API... Running post-installation verification... Cleaning up node_modules archives that don't match current API version: 4.9.5 Current archive to keep: node_modules-for-v4.9.5.tar.xz Removing archive: /boot/config/plugins/dynamix.my.servers/node_modules-for-v4.8.0+9485809.tar.xz Cleanup completed. Starting Unraid API service If no additional messages appear within 30 seconds, it is safe to refresh the page. [32m[Nest] 2856016 - [39m07/12/2025, 11:27:03 AM [32m LOG[39m [38;5;3m[PluginService] [39m[32mLoaded 0 plugins.[39m [95m[Nest] 2856016 - [39m07/12/2025, 11:27:03 AM [95m DEBUG[39m [38;5;3m[PluginCliModule] [39m[95mFound 0 CLI plugins: [39m Added bundled plugin unraid-api-plugin-connect Starting Unraid API service... Backup file not found at '/boot/config/plugins/dynamix.my.servers/node_modules-for-v4.9.5.tar.xz'. Skipping restore. Starting flash backup service... Starting the Unraid API

Just adding my 5 cents here that I'm facing the same problem. I tried both updating just the Unraid Connect plugin on my Unraid 7.1.4 OS and removing it completely and installing again.

On top of that the flash backup stopped working as well giving the following error (I tried disconnecting and reconnecting my unraid.net account to no success):

image.png

Is there a way to downgrade the plugin until it is tested thoroughly?

Edited by ProFil

Same problem

plugin: updating: dynamix.unraid.net.plg
Executing hook script: pre_plugin_checks
Checking disk space on /usr... ok. (29629MB free)


Running on supported version 7.1.4
Backing up original files...
Backup complete.
Patching header logo if necessary...
Installing package...
Cleaning up existing node_modules directory...
Removing: /usr/local/unraid-api/node_modules

+==============================================================================
| Upgrading dynamix.unraid.net-4.9.5-x86_64-1 package using /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.5-x86_64-1.txz
+==============================================================================
Pre-installing package dynamix.unraid.net-4.9.5-x86_64-1...
Removing package: dynamix.unraid.net-4.9.5-x86_64-1-upgraded-2025-07-12,21:14:48
Verifying package dynamix.unraid.net-4.9.5-x86_64-1.txz.
Installing package dynamix.unraid.net-4.9.5-x86_64-1.txz:
PACKAGE DESCRIPTION:
# dynamix.unraid.net (Unraid API)
#
# Provides the Unraid API and Connect services for Unraid OS.
# This package enables remote management, monitoring, and access
# to Unraid servers through the Unraid Connect platform.
#
# Features include system monitoring, notifications, remote access,
# and integration with the Unraid Connect dashboard.
#
# Homepage: https://unraid.net/
Executing install script for dynamix.unraid.net-4.9.5-x86_64-1.txz.
Package dynamix.unraid.net-4.9.5-x86_64-1.txz installed.
Package dynamix.unraid.net-4.9.5-x86_64-1 upgraded with new package /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.5-x86_64-1.txz.
Starting Unraid Connect installation...
Setting up Unraid API...
Running post-installation verification...
plugin: run failed: '/bin/bash' returned 1
Executing hook script: post_plugin_checks

  • Author

I noticed an updated plugin so I thought I would try it and see if it fixed the issue, but it still seems to stall at the same place:

plugin: updating: dynamix.unraid.net.plg
Executing hook script: pre_plugin_checks
plugin: downloading: dynamix.unraid.net-4.10.0-x86_64-1.txz ... done



Running on supported version 7.1.4
Backing up original files...
Backed up: /usr/local/emhttp/plugins/dynamix/DisplaySettings.page
Backed up: /usr/local/emhttp/plugins/dynamix/include/Wrappers.php
Backed up: /usr/local/emhttp/plugins/dynamix.plugin.manager/scripts/showchanges
Backed up: /usr/local/emhttp/plugins/dynamix.my.servers/Connect.page
Backed up: /usr/local/emhttp/update.htm
Backed up: /usr/local/emhttp/logging.htm
Backed up: /etc/nginx/nginx.conf
Backed up: /etc/rc.d/rc.nginx
Backup complete.
Patching header logo if necessary...
Installing package...
Removing old package file: /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.9.5-x86_64-1.txz
Cleaning up existing node_modules directory...
Removing: /usr/local/unraid-api/node_modules

+==============================================================================
| Upgrading dynamix.unraid.net package using /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.10.0-x86_64-1.txz
+==============================================================================
Pre-installing package dynamix.unraid.net-4.10.0-x86_64-1...
Removing package: dynamix.unraid.net-upgraded-2025-07-15,14:43:02
Verifying package dynamix.unraid.net-4.10.0-x86_64-1.txz.
Installing package dynamix.unraid.net-4.10.0-x86_64-1.txz:
PACKAGE DESCRIPTION:
# dynamix.unraid.net (Unraid API)
#
# Provides the Unraid API and Connect services for Unraid OS.
# This package enables remote management, monitoring, and access
# to Unraid servers through the Unraid Connect platform.
#
# Features include system monitoring, notifications, remote access,
# and integration with the Unraid Connect dashboard.
#
# Homepage: https://unraid.net/
Executing install script for dynamix.unraid.net-4.10.0-x86_64-1.txz.
Package dynamix.unraid.net-4.10.0-x86_64-1.txz installed.
Package dynamix.unraid.net upgraded with new package /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.10.0-x86_64-1.txz.
Starting Unraid Connect installation...
Setting up Unraid API...
Running setup_api.sh
Starting API setup script
Environment: CONFIG_DIR=/boot/config/plugins/dynamix.my.servers, API_BASE_DIR=/usr/local/unraid-api
UNRAID_BINARY_PATH=/usr/local/bin/unraid-api
Env file already exists
API setup completed at Tue Jul 15 14:43:07 EDT 2025
Running post-installation verification...
Running verify_install.sh
Performing comprehensive installation verification...
Checking executable files...
✓ Executable file /usr/local/bin/unraid-api exists and is executable
✓ Executable file /etc/rc.d/rc.unraid-api exists and is executable
✓ Executable file /usr/local/emhttp/plugins/dynamix.my.servers/scripts/gitflash_log exists and is executable
Checking directories...
✓ Directory /usr/local/unraid-api exists
✓ Directory /var/log/unraid-api exists
✓ Directory /usr/local/emhttp/plugins/dynamix.my.servers exists
✓ Directory /usr/local/emhttp/plugins/dynamix.unraid.net exists
✓ Directory /etc/rc.d/rc6.d exists
✓ Directory /etc/rc.d/rc0.d exists
Checking symlinks...
✓ Symlink /usr/local/bin/unraid-api exists -> ../unraid-api/dist/cli.js
✓ Symlink /usr/local/sbin/unraid-api exists -> ../bin/unraid-api
✓ Symlink /usr/bin/unraid-api exists -> ../local/bin/unraid-api
Checking configuration files...
✓ Environment file /boot/config/plugins/dynamix.my.servers/env exists
Checking shutdown configuration...
Checking for shutdown scripts in rc6.d...
✓ Shutdown script for flash-backup exists and is executable
✓ Shutdown script for unraid-api exists and is executable
✓ rc0.d symlink exists
✓ unraid-api is in PATH
Installation log file not found

Verification summary:
- Executable files errors: 0
- Directory errors: 0
- Symlink errors: 0
- Configuration errors: 0
- Shutdown configuration errors: 0
- Total errors: 0
All checks passed successfully.
Installation verification completed successfully.
Installation completed at Tue Jul 15 14:43:07 EDT 2025
Cleaning up node_modules archives that don't match current API version: 4.10.0
Current archive to keep: node_modules-for-v4.10.0.tar.xz
Removing archive: /boot/config/plugins/dynamix.my.servers/node_modules-for-v4.8.0+9485809.tar.xz
Cleanup completed.
Starting Unraid API service
DEBUG: Checking PATH: .:/usr/local/sbin:/usr/sbin:/sbin:/usr/local/bin:/usr/bin:/bin
DEBUG: Checking if unraid-api files exist:
total 80
drwxr-xr-x 3 root root 100 Jul 15 14:43 .
drwxr-xr-x 5 root root 320 Jul 15 14:43 ..
drwxr-xr-x 2 root root 460 Jul 15 14:43 assets
-rwxr-xr-x 1 root root 69534 Jul 15 14:34 cli.js
-rwxr-xr-x 1 root root 11321 Jul 15 14:34 main.js
DEBUG: Checking symlink:
lrwxrwxrwx 1 root root 25 Jul 15 14:43 /usr/local/bin/unraid-api -> ../unraid-api/dist/cli.js
DEBUG: Checking Node.js version:
v22.17.0
DEBUG: Checking if cli.js is executable:
-rwxr-xr-x 1 root root 69534 Jul 15 14:34 /usr/local/unraid-api/dist/cli.js
DEBUG: Attempting to run unraid-api directly:
Unraid API v4.10.0+81808ad
If no additional messages appear within 30 seconds, it is safe to refresh the page.
Added bundled plugin unraid-api-plugin-connect
Starting Unraid API service...
Backup file not found at '/boot/config/plugins/dynamix.my.servers/node_modules-for-v4.10.0.tar.xz'. Skipping restore.
Starting flash backup service...
Starting the Unraid API

Thanks, @elibosley - the latest version restored flash backup which was very important for me!

On that note I still face same issue with logs hanging on Starting the Unraid API just as other users stated above.

  • Community Expert

Please send the response from the prior DEBUG statements in the install, that may help us get to the bottom of this.

  • Author
plugin: updating: dynamix.unraid.net.plg
Executing hook script: pre_plugin_checks
Checking disk space on /usr... ok. (30937MB free)


Running on supported version 7.1.4
Backing up original files...
Backup complete.
Patching header logo if necessary...
Installing package...
Cleaning up existing node_modules directory...
Removing: /usr/local/unraid-api/node_modules

+==============================================================================
| Upgrading dynamix.unraid.net-4.10.0-x86_64-1 package using /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.10.0-x86_64-1.txz
+==============================================================================
Pre-installing package dynamix.unraid.net-4.10.0-x86_64-1...
Removing package: dynamix.unraid.net-4.10.0-x86_64-1-upgraded-2025-07-16,20:15:46
Verifying package dynamix.unraid.net-4.10.0-x86_64-1.txz.
Installing package dynamix.unraid.net-4.10.0-x86_64-1.txz:
PACKAGE DESCRIPTION:
# dynamix.unraid.net (Unraid API)
#
# Provides the Unraid API and Connect services for Unraid OS.
# This package enables remote management, monitoring, and access
# to Unraid servers through the Unraid Connect platform.
#
# Features include system monitoring, notifications, remote access,
# and integration with the Unraid Connect dashboard.
#
# Homepage: https://unraid.net/
Executing install script for dynamix.unraid.net-4.10.0-x86_64-1.txz.
Package dynamix.unraid.net-4.10.0-x86_64-1.txz installed.
Package dynamix.unraid.net-4.10.0-x86_64-1 upgraded with new package /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.10.0-x86_64-1.txz.
Starting Unraid Connect installation...
Setting up Unraid API...
Running setup_api.sh
Starting API setup script
Environment: CONFIG_DIR=/boot/config/plugins/dynamix.my.servers, API_BASE_DIR=/usr/local/unraid-api
UNRAID_BINARY_PATH=/usr/local/bin/unraid-api
Env file already exists
API setup completed at Wed Jul 16 20:15:56 EDT 2025
Running post-installation verification...
Running verify_install.sh
Performing comprehensive installation verification...
Checking executable files...
✓ Executable file /usr/local/bin/unraid-api exists and is executable
✓ Executable file /etc/rc.d/rc.unraid-api exists and is executable
✓ Executable file /usr/local/emhttp/plugins/dynamix.my.servers/scripts/gitflash_log exists and is executable
Checking directories...
✓ Directory /usr/local/unraid-api exists
✓ Directory /var/log/unraid-api exists
✓ Directory /usr/local/emhttp/plugins/dynamix.my.servers exists
✓ Directory /usr/local/emhttp/plugins/dynamix.unraid.net exists
✓ Directory /etc/rc.d/rc6.d exists
✓ Directory /etc/rc.d/rc0.d exists
Checking symlinks...
✓ Symlink /usr/local/bin/unraid-api exists -> ../unraid-api/dist/cli.js
✓ Symlink /usr/local/sbin/unraid-api exists -> ../bin/unraid-api
✓ Symlink /usr/bin/unraid-api exists -> ../local/bin/unraid-api
Checking configuration files...
✓ Environment file /boot/config/plugins/dynamix.my.servers/env exists
Checking shutdown configuration...
Checking for shutdown scripts in rc6.d...
✓ Shutdown script for flash-backup exists and is executable
✓ Shutdown script for unraid-api exists and is executable
✓ rc0.d symlink exists
✓ unraid-api is in PATH
 Installation log file not found

Verification summary:
- Executable files errors: 0
- Directory errors: 0
- Symlink errors: 0
- Configuration errors: 0
- Shutdown configuration errors: 0
- Total errors: 0
All checks passed successfully.
Installation verification completed successfully.
Installation completed at Wed Jul 16 20:15:56 EDT 2025
Cleaning up node_modules archives that don't match current API version: 4.10.0
Current archive to keep: node_modules-for-v4.10.0.tar.xz
Cleanup completed.
Starting Unraid API service
DEBUG: Checking PATH: .:/usr/local/sbin:/usr/sbin:/sbin:/usr/local/bin:/usr/bin:/bin
DEBUG: Checking if unraid-api files exist:
total 80
drwxr-xr-x 3 root root 100 Jul 15 14:34 .
drwxr-xr-x 5 root root 320 Jul 16 20:15 ..
drwxr-xr-x 2 root root 460 Jul 15 14:34 assets
-rwxr-xr-x 1 root root 69534 Jul 15 14:34 cli.js
-rwxr-xr-x 1 root root 11321 Jul 15 14:34 main.js
DEBUG: Checking symlink:
lrwxrwxrwx 1 root root 25 Jul 16 20:15 /usr/local/bin/unraid-api -> ../unraid-api/dist/cli.js
DEBUG: Checking Node.js version:
v22.17.0
DEBUG: Checking if cli.js is executable:
-rwxr-xr-x 1 root root 69534 Jul 15 14:34 /usr/local/unraid-api/dist/cli.js
DEBUG: Attempting to run unraid-api directly:
Unraid API v4.10.0+81808ad
If no additional messages appear within 30 seconds, it is safe to refresh the page.
Added bundled plugin unraid-api-plugin-connect
Starting Unraid API service...
Backup file not found at '/boot/config/plugins/dynamix.my.servers/node_modules-for-v4.10.0.tar.xz'. Skipping restore.
Starting flash backup service...
Starting the Unraid API

And from the syslog:

Jul 16 20:15:40 Eeyore kernel: veth363958e: entered allmulticast mode
Jul 16 20:15:40 Eeyore kernel: veth363958e: entered promiscuous mode
Jul 16 20:15:40 Eeyore kernel: eth0: renamed from veth88b209e
Jul 16 20:15:40 Eeyore kernel: br-33eb52b1cc77: port 3(veth363958e) entered blocking state
Jul 16 20:15:40 Eeyore kernel: br-33eb52b1cc77: port 3(veth363958e) entered forwarding state
Jul 16 20:15:46 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:15:46 Eeyore plugin-manager: checking: /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.10.0-x86_64-1.txz - SHA256
Jul 16 20:15:46 Eeyore plugin-manager: skipping: /boot/config/plugins/dynamix.my.servers/dynamix.unraid.net-4.10.0-x86_64-1.txz already exists
Jul 16 20:15:46 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:15:46 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:15:46 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:15:46 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:15:56 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:15:56 Eeyore plugin-manager: running: 'anonymous'
Jul 16 20:16:00 Eeyore flash_backup: stop watching for file changes
Jul 16 20:16:00 Eeyore flash_backup: flush: /usr/local/emhttp/plugins/dynamix.my.servers/scripts/UpdateFlashBackup update
Jul 16 20:16:03 Eeyore flash_backup: checking for changes every 1800 seconds
Jul 16 20:19:01 Eeyore sshd-session[3234555]: Connection from 10.253.0.8 port 54550 on 10.253.0.1 port 42378 rdomain ""
Jul 16 20:19:01 Eeyore sshd-session[3234555]: Accepted key RSA SHA256:omVgODMpc6F1wvvBgnfttvMmvr7gDpXA6BdCL+D/DGM found at /root/.ssh/authorized_keys:1
Jul 16 20:19:01 Eeyore sshd-session[3234555]: Postponed publickey for root from 10.253.0.8 port 54550 ssh2 [preauth]
Jul 16 20:19:01 Eeyore sshd-session[3234555]: Accepted key RSA SHA256:omVgODMpc6F1wvvBgnfttvMmvr7gDpXA6BdCL+D/DGM found at /root/.ssh/authorized_keys:1
Jul 16 20:19:01 Eeyore sshd-session[3234555]: Accepted publickey for root from 10.253.0.8 port 54550 ssh2: RSA SHA256:omVgODMpc6F1wvvBgnfttvMmvr7gDpXA6BdCL+D/DGM
Jul 16 20:19:01 Eeyore sshd-session[3234555]: pam_unix(sshd:session): session opened for user root(uid=0) by (uid=0)
Jul 16 20:19:01 Eeyore sshd-session[3234555]: User child is on pid 3234721
Jul 16 20:19:01 Eeyore sshd-session[3234721]: Starting session: shell on pts/2 for root from 10.253.0.8 port 54550 id 0

Also attached full Diagnostic archive.

eeyore-diagnostics-20250716-2021.zip

Edited by Mantene

  • Author

Yeah, I noticed that someone else mentioned having ZSH as their default shell. I also have ZSH as my default shell. So I am guessing this lies at the heart of the problem. The question is, why/? And how can we resolve it without my needing to switch back to bash?

  • Community Expert

Hi, we want to solve this for you but this is also an unsupported use case. Please provide the following.

  1. execution result of ls -al /bin/sh

  1. The guide followed to install Zsh on Unraid

Thank you, this will help us further understand and fix this use case.

  • Author

Eeyore:~ # ls -al /bin/sh

lrwxrwxrwx 1 root root 4 Jun 18 01:16 /bin/sh -> bash

Here is how I am switching my shell in my /boot/config/go file:
echo "if [ -d /mnt/user/appdata/zsh/.oh-my-zsh ]; then if [ -f /bin/zsh ]; then /bin/zsh; exit; fi fi" >> /root/.bash_profile

# Linking .zshrc to ~/.zshrc

ln -s /boot/config/.zshrc /root/.zshrc

ln -s /boot/config/shell/.fzf.zsh /root/.fzf.zsh

cp -R /boot/config/shell/.fzf /root/

ln -s /boot/config/shell/.zcompdump /root/.zcompdump

cp /boot/config/shell/.zcompdump-Eeyore-5.9 /root/.zcompdump-Eeyore-5.9

cp /boot/config/shell/.zcompdump-Eeyore-5.9.zwc /root/.zcompdump-Eeyore-5.9.zwc

Edited by Mantene

  • Community Expert
  • Solution

I think that the way you're setting up zsh is likely breaking a lot of boot scripts (not just ours).

TL;DR

Yes, your line can and will break Unraid plugin installs by hijacking the login shell. Fix it by guarding with -t 1 to only exec Zsh in actual interactive terminals.

Solution: Detect interactive terminal only

Modify the logic in .bash_profile to only launch Zsh if it's an interactive terminal (i.e., not from a script or system process):

Replace:

echo "if [ -d /mnt/user/appdata/zsh/.oh-my-zsh ]; then if [ -f /bin/zsh ]; then /bin/zsh; exit; fi fi" >> /root/.bash_profile 

With something safer:

echo 'if [[ -t 1 && -f /bin/zsh && -d /mnt/user/appdata/zsh/.oh-my-zsh ]]; then exec /bin/zsh; fi' >> /root/.bash_profile

Explanation:

  • [[ -t 1 ]]: Only true if the shell has a terminal attached (i.e. interactive session)

  • exec /bin/zsh: Replaces the shell process only in interactive cases

This ensures:

  • Normal user terminals get Zsh

  • Plugin scripts, cron jobs, and Unraid boot/install logic remain unaffected

  • Note: I have NOT tested this logic and using Zsh like this (as default shell) is entirely outside of Unraid supported functionality. You will continue to have issues doing this in the future.

if it helps, i was playing around with nushell & fish on unraid several months ago and switched between them explicitly instead overriding the default shell. was a fun/seamless experience!

also, if you're trying to solve for a custom/pretty/low-effort prompt line, https://starship.rs/ is compatible with bash.

  • Author

That did the trick! Thank you so much!

34 minutes ago, elibosley said:

I think that the way you're setting up zsh is likely breaking a lot of boot scripts (not just ours).

TL;DR

Yes, your line can and will break Unraid plugin installs by hijacking the login shell. Fix it by guarding with -t 1 to only exec Zsh in actual interactive terminals.

Solution: Detect interactive terminal only

Modify the logic in .bash_profile to only launch Zsh if it's an interactive terminal (i.e., not from a script or system process):

Replace:

echo "if [ -d /mnt/user/appdata/zsh/.oh-my-zsh ]; then if [ -f /bin/zsh ]; then /bin/zsh; exit; fi fi" >> /root/.bash_profile 

With something safer:

echo 'if [[ -t 1 && -f /bin/zsh && -d /mnt/user/appdata/zsh/.oh-my-zsh ]]; then exec /bin/zsh; fi' >> /root/.bash_profile

Explanation:

  • [[ -t 1 ]]: Only true if the shell has a terminal attached (i.e. interactive session)

  • exec /bin/zsh: Replaces the shell process only in interactive cases

This ensures:

  • Normal user terminals get Zsh

  • Plugin scripts, cron jobs, and Unraid boot/install logic remain unaffected

  • Note: I have NOT tested this logic and using Zsh like this (as default shell) is entirely outside of Unraid supported functionality. You will continue to have issues doing this in the future.

  • Community Expert

Really glad to hear this. I would suggest that anyone reading this thread refer to the solution above for a fix, or just utilize bash as their default shell.

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.