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.

FileSizeSHA-256
lotus-binaries-12.5.4-linux-x86_64.tar.gz40.7 MBe09dc281940bf02e3937865e25a395dcc7350b5579604d837d8d2c49dd27d266
lotusd-12.5.4-linux-x86_64.tar.gz17.8 MB93b301ed30f3ab6b3a5d51c120d8790a1ce3b7a182c1308e78e3776dc837d1bb
lotus-cli-12.5.4-linux-x86_64.tar.gz0.9 MB31ab603450ea7a0ae05454d7e3edbbc8816755f985481e9ab07637f6408663e3
lotus-tx-12.5.4-linux-x86_64.tar.gz1.2 MB08d24b964d720eafb25929f5ff50142ed66c5d5b7e84f9e4f0c45a1d3de18d33
lotus-wallet-12.5.4-linux-x86_64.tar.gz2.9 MBc45a6a2d593cb19cba0d77bea77bb7663585758935a6e80f03889dd7a15b73ad
lotus-seeder-12.5.4-linux-x86_64.tar.gz17.9 MBafe2df36a93f3ec49e0a71668206bcdf6cb53eafb29b2d7b1d46ce12047ecd82
lotus-gpu-miner-12.5.4-linux-x86_64.tar.gz2.8 MBa7481453b1ce0fbf41543c0eef5ab594c28eb0837b24b96aefac6e32538409cf

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

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