-
-
Notifications
You must be signed in to change notification settings - Fork 3.2k
Remove badger v1 datastore support #11186
Copy link
Copy link
Open
Labels
P1High: Likely tackled by core team if no one steps upHigh: Likely tackled by core team if no one steps upkind/enhancementA net-new feature or improvement to an existing featureA net-new feature or improvement to an existing feature
Metadata
Metadata
Assignees
Labels
P1High: Likely tackled by core team if no one steps upHigh: Likely tackled by core team if no one steps upkind/enhancementA net-new feature or improvement to an existing featureA net-new feature or improvement to an existing feature
Type
Fields
Give feedbackNo fields configured for issues without a type.
Checklist
Description
Rationale
The
badgerdsdatastore is based on badger 1.x which has not been maintained by its upstream maintainers for years. It has 15+ open issues with known bugsincluding startup timeouts, shutdown hangs, file descriptor exhaustion, and stdout pollution. Kubo never moved to badger v2 nor v3, and there is no path forward with this dependency.
Modern alternatives (
flatfs,pebbleds) are available and actively maintained.Related: #10347, #4279, #6818
Removal plan
Kubo v0.40 : loud deprecation error printed on every daemon start when a badger-based repository is detected. Updated profile descriptions, datastore docs, and config docs to mark badgerds as deprecated with migration guidance.
Later in 2026: remove
go-ds-badgerdependency and allbadgerdsplugin/profile code. Kubo will refuse to start if it detects a badger-based datastore config and print instructions to migrate.Migration path
It has been deprecated for years. Everyone sane migrated already.
There will be no automated migration as we know its not feasible. The way to go is to create new node and transfer data:
IPFS_PATHwithflatfs(or experimentalpebbledsifflatfsdoes not serve your use case):ipfs dag export/importoripfs pin ls -t recursive/ipfs pin add