Netbox Container not starting because of IPv6 not enabled

[lalegre145]

Current Behavior

I am having issues starting at the very first installation of netbox receiving the following error:

netbox-1 | ⚙️ Applying configuration from /etc/unit/nginx-unit.json
netbox-1 | 2026/03/11 12:35:32 [alert] 7#7 socket("[::]:8080") failed (97: Address family not supported by protocol)
netbox-1 | 2026/03/11 12:35:32 [alert] 134#134 failed to apply new con

Expected Behavior

I have tried adding:

GRANIAN_EXTRA_ARGS: "--host=0.0.0.0"

In my docker-compose-override.yml but I had no luck, it stills fails to start because of that.

Docker Compose Version

Docker Compose version v5.1.0

Docker Version

Client: Docker Engine - Community
 Version:           29.2.1
 API version:       1.53
 Go version:        go1.25.6
 Git commit:        a5c7197
 Built:             Mon Feb  2 17:17:26 2026
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          29.2.1
  API version:      1.53 (minimum version 1.44)
  Go version:       go1.25.6
  Git commit:       6bc6209
  Built:            Mon Feb  2 17:17:26 2026
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v2.2.1
  GitCommit:        dea7da592f5d1d2b7755e3a161be07f43fad8f75
 runc:
  Version:          1.3.4
  GitCommit:        v1.3.4-0-gd6d73eb8
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

The git Revision

0b70f72

The git Status

Not currently on any branch.

Startup Command

docker compose up

NetBox Logs

netbox-1 exited with code 0 (restarting)
netbox-1       | 🧬 loaded config '/etc/netbox/config/configuration.py'
netbox-1       | 🧬 loaded config '/etc/netbox/config/extra.py'
netbox-1       | 🧬 loaded config '/etc/netbox/config/logging.py'
netbox-1       | 🧬 loaded config '/etc/netbox/config/plugins.py'
netbox-1       | 💡 Superuser Username: admin, E-Mail: [email protected]
netbox-1       | 🧬 loaded config '/etc/netbox/config/configuration.py'
netbox-1       | 🧬 loaded config '/etc/netbox/config/extra.py'
netbox-1       | 🧬 loaded config '/etc/netbox/config/logging.py'
netbox-1       | 🧬 loaded config '/etc/netbox/config/plugins.py'
netbox-1       | ✅ Initialisation is done.
netbox-1       | ⏳ Waiting for control socket to be created... (1/10)
netbox-1       | 2026/03/11 12:35:31 [warn] 7#7 Unit is running unprivileged, then it cannot use arbitrary user and group.
netbox-1       | 2026/03/11 12:35:31 [info] 7#7 unit 1.34.1 started
netbox-1       | 2026/03/11 12:35:31 [info] 132#132 discovery started
netbox-1       | 2026/03/11 12:35:31 [notice] 132#132 module: python 3.12.3 "/usr/lib/unit/modules/python3.12.unit.so"
netbox-1       | 2026/03/11 12:35:31 [info] 7#7 controller started
netbox-1       | 2026/03/11 12:35:31 [notice] 7#7 process 132 exited with code 0
netbox-1       | 2026/03/11 12:35:31 [info] 134#134 router started
netbox-1       | 2026/03/11 12:35:31 [info] 134#134 OpenSSL 3.0.13 30 Jan 2024, 300000d0
netbox-1       | ⚙️ Applying configuration from /etc/unit/nginx-unit.json
netbox-1       | 2026/03/11 12:35:32 [alert] 7#7 socket(\"[::]:8080\") failed (97: Address family not supported by protocol)
netbox-1       | 2026/03/11 12:35:32 [alert] 134#134 failed to apply new conf
netbox-1       | ⚠️ Could no load Unit configuration
netbox-1       | 2026/03/11 12:35:32 [notice] 7#7 process 130 exited with code 1
netbox-1       | 2026/03/11 12:35:32 [notice] 7#7 process 133 exited with code 0
netbox-1       | 2026/03/11 12:35:32 [notice] 7#7 process 134 exited with code 0

Content of docker-compose.override.yml

services:
  netbox:
    environment:
      GRANIAN_EXTRA_ARGS: "--host=0.0.0.0"
    security_opt:
     - seccomp:unconfined
    ports:
     - "8081:8080"
  netbox-worker:
    security_opt:
     - seccomp:unconfined

[tobiasge]

You are running an old version of the container. GRANIAN_EXTRA_ARGS only works for netbox-docker >4.0 and NetBox >4.5.
In the old versions you have to mount a custom nginx-unit.json.

[lalegre145]

@tobiasge thanks for the fast response, is there any example around on how to upload a custom .json to the netbox container?

[tobiasge]

You can find in the history of the Wiki page: https://github.com/netbox-community/netbox-docker/wiki/Troubleshooting/_compare/cb2554023b66cc074bdeadd7779410d8aed2c6a0...a00192604666fd1b436a574038330462b9462153

[lalegre145]

That was it!

Thanks you very much.