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.

FileSizeSHA-256
lotus-binaries-12.5.1-linux-x86_64.tar.gz33.9 MBd73cb2f6c094e0f3fc3a2056899733addbbf268b74096fae6d3d05ef604a0bfc
lotusd-12.5.1-linux-x86_64.tar.gz14.4 MB36c9604e827abd0e463dd54923be9b26d91ffd375e01a41883cbde57ded651f1
lotus-cli-12.5.1-linux-x86_64.tar.gz0.9 MB7b6e701339aa004decf975c1fe351d57a07d83998a6840934129c9b1f0adc80a
lotus-tx-12.5.1-linux-x86_64.tar.gz1.2 MB8707ee373542d16609a79b383ed6ebfff6e221405d3791bad8596ec511099c41
lotus-wallet-12.5.1-linux-x86_64.tar.gz2.9 MBa48f266ee92a6b63be2b8bda9eb10d7bb05159356b9252ee79ed1d5277fe1ae5
lotus-seeder-12.5.1-linux-x86_64.tar.gz14.5 MB1ce837538e05de8a2bb3da8ec08b86d8e47a8f7ee1f1457513a146aa4d3c8ea6
lotus-gpu-miner-12.5.1-linux-x86_64.tar.gz2.8 MBd90526d9388ab93aabec0f3a0e0ce26b4b8926d9ddc90bbfbffd7c04ee8ca59c

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.1

Source 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 SHA256SUMS

Upgrade 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 -d

With 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 -daemon

Then check the version: lotus-cli getnetworkinfo shows it in subversion.