Lotus node release ยท Latest
lotusd 12.5.4
Published 21 November 2026
Live sync heights of peers
Napoleon, 21 December 2026, 20:50 UTC: every node must run 12.5.1 or later before then. This version qualifies. Earlier versions, 12.4.x included, do not follow the chain after the fork.
This is the latest release. All releases
What is new
- Live sync heights of peers: nodes tell their peers their height each time it moves, so the peer list shows how far a syncing node has got, updated every few seconds, instead of the height it had when it connected. For older peers the height is taken from the blocks they ask for.
- Slow peers stay connected: a peer that is busy syncing and slow to answer pings is no longer disconnected while it keeps talking to the node.
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.4-linux-x86_64.tar.gz | 40.7 MB | e09dc281940bf02e3937865e25a395dcc7350b5579604d837d8d2c49dd27d266 |
| lotusd-12.5.4-linux-x86_64.tar.gz | 17.8 MB | 93b301ed30f3ab6b3a5d51c120d8790a1ce3b7a182c1308e78e3776dc837d1bb |
| lotus-cli-12.5.4-linux-x86_64.tar.gz | 0.9 MB | 31ab603450ea7a0ae05454d7e3edbbc8816755f985481e9ab07637f6408663e3 |
| lotus-tx-12.5.4-linux-x86_64.tar.gz | 1.2 MB | 08d24b964d720eafb25929f5ff50142ed66c5d5b7e84f9e4f0c45a1d3de18d33 |
| lotus-wallet-12.5.4-linux-x86_64.tar.gz | 2.9 MB | c45a6a2d593cb19cba0d77bea77bb7663585758935a6e80f03889dd7a15b73ad |
| lotus-seeder-12.5.4-linux-x86_64.tar.gz | 17.9 MB | afe2df36a93f3ec49e0a71668206bcdf6cb53eafb29b2d7b1d46ce12047ecd82 |
| lotus-gpu-miner-12.5.4-linux-x86_64.tar.gz | 2.8 MB | a7481453b1ce0fbf41543c0eef5ab594c28eb0837b24b96aefac6e32538409cf |
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.4Source 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.4
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.4
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.4-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.
