ipfs/kubo · error

provider: error flushing MFS, cannot provide MFS: %w

Error message

provider: error flushing MFS, cannot provide MFS: %w

What it means

The MFS provider key source failed before enumerating content: flushing the in-memory MFS tree to disk (FlushMemFree) errored, so the root's complete CID list cannot be produced and providing MFS content is skipped with this error.

Source

Thrown at core/node/provider.go:1205

		opts = append(opts, LegacyProviderOpt(reprovideInterval, providerStrategy, acceleratedDHTClient, provideWorkerCount))
	}

	return fx.Options(opts...)
}

// OfflineProviders groups units managing provide routing records offline
func OfflineProviders() fx.Option {
	return fx.Provide(func() DHTProvider {
		return &NoopProvider{}
	})
}

func mfsProvider(mfsRoot *mfs.Root, fetcher fetcher.Factory) provider.KeyChanFunc {
	return func(ctx context.Context) (<-chan cid.Cid, error) {
		err := mfsRoot.FlushMemFree(ctx)
		if err != nil {
			return nil, fmt.Errorf("provider: error flushing MFS, cannot provide MFS: %w", err)
		}
		rootNode, err := mfsRoot.GetDirectory().GetNode()
		if err != nil {
			return nil, fmt.Errorf("provider: error loading MFS root, cannot provide MFS: %w", err)
		}

		kcf := provider.NewDAGProvider(rootNode.Cid(), fetcher)
		return kcf(ctx)
	}
}

type provStrategyIn struct {
	fx.In
	Pinner               pin.Pinner
	Blockstore           blockstore.Blockstore
	OfflineIPLDFetcher   fetcher.Factory `name:"offlineIpldFetcher"`
	OfflineUnixFSFetcher fetcher.Factory `name:"offlineUnixfsFetcher"`
	MFSRoot              *mfs.Root

View on GitHub (pinned to 329838acdf)

Solutions

1. Retry the reprovide; transient datastore errors during flush are common
2. Check datastore health and disk space
3. If MFS is corrupt, inspect 'ipfs files stat /' and repair or rebuild the files tree

When it happens

Trigger: Thrown at core/node/provider.go:1205 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/a7c877ee2069b281. Report an issue: GitHub.