ipfs/kubo · error

creating libp2p resource manager: %w

Error message

creating libp2p resource manager: %w

What it means

Fired during node construction (rcmgr construction in core/node/libp2p) when rcmgr.NewResourceManager fails to build the libp2p resource manager from the fixed limiter and options (e.g. invalid allowlist state or limiter configuration). It wraps the underlying error and prevents daemon startup, since the resource manager is mandatory.

Source

Thrown at core/node/libp2p/rcmgr.go:112

						log.Errorf("failed to parse multiaddr=%v for allowlist, skipping. err=%v", maStr, err)
						continue
					}
					mas = append(mas, ma)
				}
				ropts = append(ropts, rcmgr.WithAllowlistedMultiaddrs(mas))
				log.Infof("Setting allowlist to: %v", mas)
			}

			if os.Getenv("LIBP2P_DEBUG_RCMGR") != "" {
				traceFilePath := filepath.Join(repoPath, NetLimitTraceFilename)
				ropts = append(ropts, rcmgr.WithTrace(traceFilePath))
			}

			limiter := rcmgr.NewFixedLimiter(limitConfig)

			manager, err = rcmgr.NewResourceManager(limiter, ropts...)
			if err != nil {
				return nil, opts, fmt.Errorf("creating libp2p resource manager: %w", err)
			}
			lrm := &loggingResourceManager{
				logger:   &logging.Logger("resourcemanager").SugaredLogger,
				delegate: manager,
			}
			lrm.start(helpers.LifecycleCtx(mctx, lc))
			manager = lrm
		} else {
			rcmgrLogger.Info("go-libp2p resource manager protection disabled")
			manager = &network.NullResourceManager{}
		}

		opts.Opts = append(opts.Opts, libp2p.ResourceManager(manager))

		lc.Append(fx.Hook{
			OnStop: func(ctx context.Context) error {
				return shutdown.CloseWithCtx(ctx, "resource-manager", manager.Close)
			},

View on GitHub (pinned to 329838acdf)

Solutions

1. Check Swarm.ResourceMgr.Allowlist entries are valid multiaddrs
2. Unset LIBP2P_DEBUG_RCMGR if the trace file path is not writable
3. Simplify Swarm.ResourceMgr config to defaults and re-add custom settings step by step

When it happens

Trigger: Thrown at core/node/libp2p/rcmgr.go:112 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ipfs/kubo@329838acdf (2026-09-03). Data as JSON: /api/errors/4ed5731ee0017231. Report an issue: GitHub.