Lotus node release
lotusd 12.5.1
Published 20 November 2026
Ready for the Napoleon fork
Required before 21 December 2026 at 20:50 UTC
Napoleon, 21 December 2026, 20:50 UTC: every node must run 12.5.1 or later before then. This version qualifies. Until Napoleon it follows the same rules as 12.4.x, so you can upgrade now. Earlier versions, 12.4.x included, do not follow the chain after the fork.
A newer release exists: 12.5.2. All releases
What is new
- Merged mining on real parent chains: from Napoleon, merged-mined blocks must be anchored to real Bitcoin, eCash, Bitcoin Cash or Litecoin blocks.
- Merged-mining pools: what a pool sets is on the Napoleon page, lotusia.network/napoleon/#pools.
- One difficulty lane per parent chain: from Napoleon, merged mining on Bitcoin, eCash, Bitcoin Cash and Litecoin each has its own difficulty, and a miner picks the chain by its stratum port. Merged mining cannot crowd out native mining.
- Parent chains in the dashboard: the explorer and the network pages show the parent chains Lotus follows.
- Rewards spendable sooner: from Napoleon, block rewards and pool payouts can be spent after 20 blocks (about 40 minutes).
- Upgrade notice: the node tells you when a newer version is announced by enough of its peers.
Downloads
Linux x86_64. The archive "lotus-binaries" holds the node and every tool; take it unless you need less.
| File | Size | SHA-256 |
|---|---|---|
| lotus-binaries-12.5.1-linux-x86_64.tar.gz | 33.9 MB | d73cb2f6c094e0f3fc3a2056899733addbbf268b74096fae6d3d05ef604a0bfc |
| lotusd-12.5.1-linux-x86_64.tar.gz | 14.4 MB | 36c9604e827abd0e463dd54923be9b26d91ffd375e01a41883cbde57ded651f1 |
| lotus-cli-12.5.1-linux-x86_64.tar.gz | 0.9 MB | 7b6e701339aa004decf975c1fe351d57a07d83998a6840934129c9b1f0adc80a |
| lotus-tx-12.5.1-linux-x86_64.tar.gz | 1.2 MB | 8707ee373542d16609a79b383ed6ebfff6e221405d3791bad8596ec511099c41 |
| lotus-wallet-12.5.1-linux-x86_64.tar.gz | 2.9 MB | a48f266ee92a6b63be2b8bda9eb10d7bb05159356b9252ee79ed1d5277fe1ae5 |
| lotus-seeder-12.5.1-linux-x86_64.tar.gz | 14.5 MB | 1ce837538e05de8a2bb3da8ec08b86d8e47a8f7ee1f1457513a146aa4d3c8ea6 |
| lotus-gpu-miner-12.5.1-linux-x86_64.tar.gz | 2.8 MB | d90526d9388ab93aabec0f3a0e0ce26b4b8926d9ddc90bbfbffd7c04ee8ca59c |
Windows and macOS files, the desktop miner and the release notes are on the GitHub release: the full release on GitHub ยท SHA256SUMS
Docker image
docker pull ghcr.io/lotusdevorg/lotusd:12.5.1Source code
The source code is not published for this release.
Verify your download
Check the archive against the release's SHA256SUMS before you run it. The command must print OK.
V=12.5.1
BASE=https://github.com/LotusDevOrg/lotusd-releases/releases/download/v$V
curl -fsSLO $BASE/SHA256SUMS
curl -fsSLO $BASE/lotus-binaries-$V-linux-x86_64.tar.gz
sha256sum -c --ignore-missing SHA256SUMSUpgrade a node
With Docker Compose
Set the image to the new version in your compose file, then pull and restart. Give the node time to stop cleanly (stop_grace_period: 120s).
# docker-compose.yml
image: ghcr.io/lotusdevorg/lotusd:12.5.1
stop_grace_period: 120s
docker compose pull
docker compose up -dWith the binaries
Stop the node, replace the programs with the new ones, start it again. Keep the data directory.
lotus-cli stop
tar xzf lotus-binaries-12.5.1-linux-x86_64.tar.gz
# copy the programs over the old ones, then:
lotusd -daemonThen check the version: lotus-cli getnetworkinfo shows it in subversion.
