Skip to content

docs: loud deprecation of badger v1 datastore - #11187

Merged
lidel merged 2 commits into
masterfrom
deprecate-badgerds
Feb 9, 2026
Merged

lidel merged 2 commits into
masterfrom
deprecate-badgerds

Conversation

@lidel

@lidel lidel commented Feb 9, 2026 •

Copy link
Copy Markdown
Contributor

This is documentation-only change that applies more pressure to any remaining users of ancient badgerv1 backend.

Mainly opportunity to close old issues that no longer apply.

Details

badger v1 (go-ds-badger) has not been maintained by its upstream maintainers for years and has known bugs (startup timeouts, shutdown hangs, fd exhaustion). make the deprecation loud and unavoidable:

  • print ERROR log line and bordered stderr message on every daemon start when a badger-based datastore is detected
  • mark badgerds and badgerds-measure init profiles as DEPRECATED
  • update docs/datastores.md and docs/config.md with migration guidance
  • add changelog highlight for v0.40

badger v1 support will be removed later in 2026.

Demo

$ ipfs init --profile=badgerds                                                                                                                                                                                                                                                                  130 ...bo ?deprecate-badgerds
generating ED25519 keypair...done
peer identity: 12D3KooWCcPUc8fwAmV9e2sWgKvHXjaQiSwmXbnaNPeax3gFgLjq
initializing IPFS node at /tmp/claude/ipfs-wn8NnQdsfdsfsfd
2026-02-09T21:58:23.169+0100	ERROR	plugin/badgerds	badgerds/badgerds.go:114	badger v1 datastore is deprecated and will be removed later in 2026, migrate to flatfs or experimental pebbleds: https://github.com/ipfs/kubo/issues/11186

โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
โ•‘                                                                            โ•‘
โ•‘  ERROR: BADGER v1 DATASTORE IS DEPRECATED                                  โ•‘
โ•‘                                                                            โ•‘
โ•‘  This datastore is based on badger 1.x which has not been maintained       โ•‘
โ•‘  by its upstream maintainers for years and has known bugs (startup         โ•‘
โ•‘  timeouts, shutdown hangs, file descriptor exhaustion, and more).          โ•‘
โ•‘                                                                            โ•‘
โ•‘  Badger v1 support will be REMOVED later in 2026.                          โ•‘
โ•‘                                                                            โ•‘
โ•‘  To migrate:                                                               โ•‘
โ•‘    1. Create a new IPFS_PATH with flatfs (or experimental pebbleds         โ•‘
โ•‘       if flatfs does not serve your use case):                             โ•‘
โ•‘         export IPFS_PATH=/path/to/new/repo                                 โ•‘
โ•‘         ipfs init --profile=flatfs                                         โ•‘
โ•‘    2. Move pinned data via ipfs dag export/import                          โ•‘
โ•‘       or ipfs pin ls -t recursive|add                                      โ•‘
โ•‘    3. Decommission the old badger-based node                               โ•‘
โ•‘                                                                            โ•‘
โ•‘  See https://github.com/ipfs/kubo/blob/master/docs/datastores.md           โ•‘
โ•‘      https://github.com/ipfs/kubo/issues/11186                             โ•‘
โ•‘                                                                            โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

References

Closes

lidel added 2 commits February 9, 2026 20:33
badger v1 (go-ds-badger) has not been maintained by its upstream
maintainers for years and has known bugs (startup timeouts, shutdown
hangs, fd exhaustion). make the deprecation loud and unavoidable:

- print ERROR log line and bordered stderr message on every daemon
  start when a badger-based datastore is detected
- mark badgerds and badgerds-measure init profiles as DEPRECATED
- update docs/datastores.md and docs/config.md with migration guidance
- add changelog highlight for v0.40

badger v1 support will be removed later in 2026.

part of #11186
@lidel
lidel marked this pull request as ready for review February 9, 2026 20:55
@lidel
lidel requested a review from a team as a code owner February 9, 2026 20:55
@lidel

lidel commented Feb 9, 2026

Copy link
Copy Markdown
Contributor Author

Merging to include in 0.40.0-rc1 and get early feedback on #11186

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment