docs: add SQL migration release notes

Document the default KVDB-to-SQL migration in the 0.17.0 release
notes, including the new databasebackend option and the available
SQLite and Postgres backends.

Also note that users who want to remain on bbolt must set
databasebackend=bbolt before the SQL migration runs, since the legacy
bbolt database is tombstoned after a successful migration.

Mark the bbolt backend as deprecated and note that support will be
removed in a future release.
This commit is contained in:
Viktor Torstensson 2026-05-19 12:42:03 +02:00
parent 468ef43f32
commit b38a80a741
No known key found for this signature in database
GPG key ID: 961CC8259AE675D4

View file

@ -24,6 +24,31 @@
### Functional Changes/Additions
* [Support for SQL database
backends](https://github.com/lightninglabs/lightning-terminal/pull/1305):
Litd now supports SQLite and postgres database backends. The old BBolt
database backend is now officially deprecated.
* [Migration to SQL by
default](https://github.com/lightninglabs/lightning-terminal/pull/1305):
Litd will now migrate its internal databases to SQL by default the first
time litd is restarted after this release. A new `databasebackend` config
option can be used to choose between an SQL-backed SQLite database
(`databasebackend=sqlite`) or a Postgres database backend
(`databasebackend=postgres`). If the config option is not set, the database
backend defaults to SQLite.
* [BBolt databases are
deprecated](https://github.com/lightninglabs/lightning-terminal/pull/1305):
Users that explicitly want to continue using the legacy `bbolt` backend must
set `databasebackend=bbolt` before the SQL migration has been applied.
Note that once the SQL migration completes successfully the old `bbolt`
database is tombstoned, and the database becomes incompatible with litd. This
also means that you will no longer be able to downgrade litd to a version
prior to when SQL was supported, which was in this release (v0.17.0-alpha).
The `bbolt` backend is now officially deprecated, and support for it will be
removed in a future release.
* [Show asset information on
payinvoice](https://github.com/lightninglabs/lightning-terminal/pull/1253):
The `litcli ln payinvoice` command now displays an asset-aware confirmation
@ -53,3 +78,4 @@
* Boris Nagaev
* darioAnongba
* Viktor-T11