UniFi Network Application Add-on Fails to Start

[nadimz]

The add-on fails to start (exits) with code 256 (by signal 9). When the watchdog is enabled, it will continuously try to restart the add-on but the same failure keeps happening. (Seems similar issue to #552 which was closed but never resolved)

Hardware

Intel(R) Core(TM) i3-6100U CPU @ 2.30GHz
4GB RAM
SSD with 120 GB (100 GB free)

System information

 Add-on version: 4.1.0
 You are running the latest version of this add-on.
 System: Home Assistant OS 15.2  (amd64 / generic-x86-64)
 Home Assistant Core: 2025.6.3
 Home Assistant Supervisor: 2025.06.2

Add-on Logs

-----------------------------------------------------------
 Add-on: UniFi Network Application
 Manage your UniFi network using a web browser
-----------------------------------------------------------
 Add-on version: 4.1.0
 You are running the latest version of this add-on.
 System: Home Assistant OS 15.2  (amd64 / generic-x86-64)
 Home Assistant Core: 2025.6.3
 Home Assistant Supervisor: 2025.06.2
-----------------------------------------------------------
 Please, share the above information when looking for help
 or support in, e.g., GitHub, forums or the Discord chat.
-----------------------------------------------------------
s6-rc: info: service base-addon-banner successfully started
s6-rc: info: service fix-attrs: starting
s6-rc: info: service base-addon-timezone: starting
s6-rc: info: service base-addon-log-level: starting
s6-rc: info: service fix-attrs successfully started
[08:51:28] INFO: Configuring timezone (Europe/Madrid)...
s6-rc: info: service base-addon-log-level successfully started
s6-rc: info: service base-addon-timezone successfully started
s6-rc: info: service legacy-cont-init: starting
s6-rc: info: service legacy-cont-init successfully started
s6-rc: info: service init-unifi: starting
s6-rc: info: service init-unifi successfully started
s6-rc: info: service unifi: starting
s6-rc: info: service unifi successfully started
s6-rc: info: service legacy-services: starting
s6-rc: info: service legacy-services successfully started
[08:51:28] INFO: Now starting the UniFi Network Application...
[08:51:28] INFO: Note: No add-on specific logs beyond this point.
[08:51:41] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:51:41] INFO: Now starting the UniFi Network Application...
[08:51:41] INFO: Note: No add-on specific logs beyond this point.
[08:51:56] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:51:56] INFO: Now starting the UniFi Network Application...
[08:51:56] INFO: Note: No add-on specific logs beyond this point.
[08:52:10] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:52:10] INFO: Now starting the UniFi Network Application...
[08:52:10] INFO: Note: No add-on specific logs beyond this point.
[08:52:21] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:52:21] INFO: Now starting the UniFi Network Application...
[08:52:21] INFO: Note: No add-on specific logs beyond this point.
[08:52:33] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:52:33] INFO: Now starting the UniFi Network Application...
[08:52:33] INFO: Note: No add-on specific logs beyond this point.
[08:52:46] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:52:46] INFO: Now starting the UniFi Network Application...
[08:52:46] INFO: Note: No add-on specific logs beyond this point.
[08:52:56] INFO: Service UniFi Network Application exited with code 256 (by signal 9)
[08:52:56] INFO: Now starting the UniFi Network Application...
[08:52:56] INFO: Note: No add-on specific logs beyond this point.

Supervisor Logs

2025-06-27 08:39:24.163 WARNING (MainThread) [supervisor.addons.addon] Watchdog found addon UniFi Network Application is unhealthy, restarting...
2025-06-27 08:39:24.300 INFO (SyncWorker_6) [supervisor.docker.manager] Stopping addon_a0d7b954_unifi application
2025-06-27 08:39:29.119 INFO (SyncWorker_6) [supervisor.docker.manager] Cleaning addon_a0d7b954_unifi application
2025-06-27 08:39:29.806 INFO (MainThread) [supervisor.docker.addon] Starting Docker add-on ghcr.io/hassio-addons/unifi/amd64 with version 4.1.0
2025-06-27 08:41:20.518 WARNING (MainThread) [supervisor.addons.addon] Watchdog found addon UniFi Network Application is unhealthy, restarting...
2025-06-27 08:41:20.539 INFO (SyncWorker_4) [supervisor.docker.manager] Stopping addon_a0d7b954_unifi application
2025-06-27 08:41:25.751 INFO (SyncWorker_4) [supervisor.docker.manager] Cleaning addon_a0d7b954_unifi application
2025-06-27 08:41:26.295 INFO (MainThread) [supervisor.docker.addon] Starting Docker add-on ghcr.io/hassio-addons/unifi/amd64 with version 4.1.0
2025-06-27 08:46:25.844 WARNING (MainThread) [supervisor.addons.addon] Watchdog found addon UniFi Network Application is unhealthy, restarting...
2025-06-27 08:46:25.853 INFO (SyncWorker_1) [supervisor.docker.manager] Stopping addon_a0d7b954_unifi application
2025-06-27 08:46:30.759 INFO (SyncWorker_1) [supervisor.docker.manager] Cleaning addon_a0d7b954_unifi application
2025-06-27 08:46:31.385 INFO (MainThread) [supervisor.docker.addon] Starting Docker add-on ghcr.io/hassio-addons/unifi/amd64 with version 4.1.0
2025-06-27 08:49:23.866 WARNING (MainThread) [supervisor.addons.addon] Watchdog found addon UniFi Network Application is unhealthy, restarting...
2025-06-27 08:49:23.871 INFO (SyncWorker_0) [supervisor.docker.manager] Stopping addon_a0d7b954_unifi application
2025-06-27 08:49:28.510 INFO (SyncWorker_0) [supervisor.docker.manager] Cleaning addon_a0d7b954_unifi application
2025-06-27 08:49:29.156 INFO (MainThread) [supervisor.docker.addon] Starting Docker add-on ghcr.io/hassio-addons/unifi/amd64 with version 4.1.0
2025-06-27 08:51:21.637 WARNING (MainThread) [supervisor.addons.addon] Watchdog found addon UniFi Network Application is unhealthy, restarting...
2025-06-27 08:51:21.647 INFO (SyncWorker_3) [supervisor.docker.manager] Stopping addon_a0d7b954_unifi application
2025-06-27 08:51:26.348 INFO (SyncWorker_3) [supervisor.docker.manager] Cleaning addon_a0d7b954_unifi application
2025-06-27 08:51:26.955 INFO (MainThread) [supervisor.docker.addon] Starting Docker add-on ghcr.io/hassio-addons/unifi/amd64 with version 4.1.0
2025-06-27 08:53:27.912 WARNING (MainThread) [supervisor.addons.addon] Watchdog found addon UniFi Network Application is unhealthy, restarting...
2025-06-27 08:53:27.920 INFO (SyncWorker_5) [supervisor.docker.manager] Stopping addon_a0d7b954_unifi application
2025-06-27 08:53:33.509 INFO (SyncWorker_5) [supervisor.docker.manager] Cleaning addon_a0d7b954_unifi application

[droopanu]

Try to increase the memory allocation and see if it fixes it. This is how it's set on my server, but you might want to tweak it for your case, as it seems you only have 4GB in your server.

[nadimz]

Try to increase the memory allocation and see if it fixes it. This is how it's set on my server, but you might want to tweak it for your case, as it seems you only have 4GB in your server.

I didn't set any value in memory allocation. Not sure what the defaults are. But I can set some initial value and play around with it. It's unclear to me how memory constrains are managed for add-ons but 4GB are plenty for my setup. Thanks.

[ChristophHoltmann]

I have the exact same problem and logs.

The defaults should be 265mb max and 128mb init. I tried some other configurations, but it does not prevent the addon from crashing.

[github-actions]

There hasn't been any activity on this issue recently, so we clean up some of the older and inactive issues.
Please make sure to update to the latest version and check if that solves the issue. Let us know if that works for you by leaving a comment 👍
This issue has now been marked as stale and will be closed if no further activity occurs. Thanks!