Nginx-proxy-manager app installation hangs - how to debug

TrueNAS General
1

I had nginx-proxy-manager up and running and all was good. Then I messed some things up and decided to delete the app and start again. I also deleted the images and volumes.

Since then I seem to be unable to recreate it. It generally hangs on “App installation in progress, pulling images”. The app actually appears in the app list at some point, but won’t start. In /var/log/app_lifecycle.log I see [2025/05/28 17:10:56] (ERROR) app_lifecycle.compose_action():56 - Failed 'up' action for 'nginx-proxy-manager' app: Timed out waiting for response, but no further details.

Are there any better ways to debug/diagnose what’s going on?

2

I had the idea to try to recreate it with a new/unique name which seems to have made it appear back on the apps page immediately rather than hanging on install. However, it is stuck on ‘deploying’. The npm logs (via the button in the UI) display:

2025-05-28 16:49:04.028232+00:00e[1;34m❯ e[1;36mConfiguring npm user ...e[0m
2025-05-28 16:49:08.861245+00:00useradd warning: npm's uid 568 outside of the UID_MIN 1000 and UID_MAX 60000 range.
2025-05-28 16:49:13.363193+00:00e[1;34m❯ e[1;36mConfiguring npm group ...e[0m
2025-05-28 16:49:13.652582+00:00e[1;34m❯ e[1;36mChecking paths ...e[0m
2025-05-28 16:49:14.904095+00:00e[1;34m❯ e[1;36mSetting ownership ...e[0m

and hangs there :-/

3

Verify that the apps user has permissions to read and write the host path volume(s) you’ve pointed it at.

4

User permissions were right, but I needed this hack: