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.

FileSizeSHA-256
lotus-binaries-12.5.3-linux-x86_64.tar.gz40.7 MBd982e9c7a0de3438b61da5c7a9cebceb2464513e483bd60283d24bfecac44982
lotusd-12.5.3-linux-x86_64.tar.gz17.8 MBb478741f0986ab57a1a0eafe1f299a6699d176f3489952274547b035713808ea
lotus-cli-12.5.3-linux-x86_64.tar.gz0.9 MB68b5941ac93e22359e17bc51ebef5d16ed31edbd62c182b19e9da9610326a911
lotus-tx-12.5.3-linux-x86_64.tar.gz1.2 MB67fa936d82b1617ed05a21177d77655e8ed7f32d3595cc2a8e3ebb36b67cd1ea
lotus-wallet-12.5.3-linux-x86_64.tar.gz2.9 MBfc14e35b2022a0567b1c7d7b92f168b77fea2de72893098274c716f29d3a5666
lotus-seeder-12.5.3-linux-x86_64.tar.gz17.9 MB65ad8513ce1885f9db5d8492633a0d906b0a100546c900f0bcd9eb7177bc19e5
lotus-gpu-miner-12.5.3-linux-x86_64.tar.gz2.8 MBef4cd681557791112cdad4b811f3ff979025ad29dc147501b3dcd0b3927ed891

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

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