Lotus node release ยท Latest
lotusd 12.5.3
Published 20 November 2026
Forks and reorgs, recorded and shown
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
- Forks and reorgs, recorded and shown: the node keeps a history of reorganisations, orphaned and held blocks, side branches and parked chains, and groups them into episodes. A new Network page shows them live and over time, with the blocks each side won and lost.
- Up-to-date node documentation: the documentation served by the node now uses this release in its examples and walks through the upgrade to 12.5.x, the Napoleon requirement included.
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.3-linux-x86_64.tar.gz | 40.7 MB | d982e9c7a0de3438b61da5c7a9cebceb2464513e483bd60283d24bfecac44982 |
| lotusd-12.5.3-linux-x86_64.tar.gz | 17.8 MB | b478741f0986ab57a1a0eafe1f299a6699d176f3489952274547b035713808ea |
| lotus-cli-12.5.3-linux-x86_64.tar.gz | 0.9 MB | 68b5941ac93e22359e17bc51ebef5d16ed31edbd62c182b19e9da9610326a911 |
| lotus-tx-12.5.3-linux-x86_64.tar.gz | 1.2 MB | 67fa936d82b1617ed05a21177d77655e8ed7f32d3595cc2a8e3ebb36b67cd1ea |
| lotus-wallet-12.5.3-linux-x86_64.tar.gz | 2.9 MB | fc14e35b2022a0567b1c7d7b92f168b77fea2de72893098274c716f29d3a5666 |
| lotus-seeder-12.5.3-linux-x86_64.tar.gz | 17.9 MB | 65ad8513ce1885f9db5d8492633a0d906b0a100546c900f0bcd9eb7177bc19e5 |
| lotus-gpu-miner-12.5.3-linux-x86_64.tar.gz | 2.8 MB | ef4cd681557791112cdad4b811f3ff979025ad29dc147501b3dcd0b3927ed891 |
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.3Source 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.3
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.3
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.3-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.
