Repository navigation
tools: install lightning-downgrade, update its docs - #9747
Merged
sangbida merged 2 commits intoNov 19, 2026
Merged
Conversation
lightning-downgrade is built with the other tools but is not in BIN_PROGRAMS, so "make install" does not copy it to bindir. The release archives are made from that install, so they have the manual page and not the program: a node upgraded from the release binaries cannot go back without building the tool from source. Add it to BIN_PROGRAMS, next to lightning-hsmtool. Install and uninstall both work from that list. Changelog-Fixed: Tools: `lightning-downgrade` is now installed by `make install` and included in the release archives. Fixes: ElementsProject#9746
The VERSIONS section of lightning-downgrade(8) ended at v25.12. Add v26.04, v26.06 and v26.12. Each goes back one release. The v26.12 tool also removes askrene impressions from the stored layers, because v26.06 cannot read them. The upgrade guide said that downgrades are not generally possible and did not mention the tool. Name it there. Changelog-None
ksedgwic
force-pushed
the
install-lightning-downgrade
branch
from
November 18, 2026 22:08
bccfa13 to
4fcd625
Compare
sangbida
approved these changes
Nov 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
lightning-downgradeis built butmake installdoes not install it, so the release archives contain its manual page and not the program. Fixes #9746.The first commit adds the tool to
BIN_PROGRAMS, next tolightning-hsmtool. Install, uninstall and the release archives (built withmake install DESTDIR=...) follow from that list, andmake installcheckpasses with it. The second commit brings the VERSIONS section of the manual page up to v26.12 and names the tool in the upgrade guide.One thing to confirm in review: I found no reason for the omission in #8702, its commits or the docs, so this PR treats it as an oversight. If the tool was left out of the install on purpose, the reason is worth recording and this PR should be closed.