Lotus node release ยท Latest

lotusd 12.5.2

Published 20 November 2026

Lighter thin nodes, a faster web UI, per-chain charts

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

  • Thin nodes stop rewriting their disk: a thin node started from a snapshot no longer downloads old blocks again and again; its disk writes drop to what each new block needs.
  • Explorer, the first block is always indexed: the explorer tables no longer depend on start-up timing for the genesis block.
  • A responsive web UI under load: idle browser and proxy connections no longer hold the node's request threads, so pages and the API answer at once while several tabs or a reverse proxy are connected.
  • Charts per parent chain: the difficulty and hashrate charts draw one series per chain (Lotus, Bitcoin, eCash, Bitcoin Cash, Litecoin), each in its own colour.
  • Accurate peer flags: a peer's country now comes from exact address ranges, for IPv4 and IPv6, with its network operator. The table is built into the node: no address leaves it.
  • Pages for tokens, blobs and games: tokens, blobs, POKR and eMPP get their own pages, and a protocol transaction shows its payload decoded field by field.

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.2-linux-x86_64.tar.gz40.5 MB41d4f3827c65d6685a3e9e1e727fa76444416f50abc7880666a43675915731eb
lotusd-12.5.2-linux-x86_64.tar.gz17.7 MBb2b7e5c8194081167eed2677d8012a399b4d0fef87fad223483010cb5ba8bffd
lotus-cli-12.5.2-linux-x86_64.tar.gz0.9 MB49ecd3299bc14d84da19b612a98568126f8f92c01cafcfb1fe456da92a6e4ba1
lotus-tx-12.5.2-linux-x86_64.tar.gz1.2 MB67745e77015c44a00c87466df6154b7cbfcb3fef93f887029ccdab0fddeac230
lotus-wallet-12.5.2-linux-x86_64.tar.gz2.9 MBb002a3f044605ab2755b0efe6f466edfe41e21f05ba296939ceef53983a30c6e
lotus-seeder-12.5.2-linux-x86_64.tar.gz17.7 MB8b0b83e43d3327c073dd52ac4ccea0857743ea349726156546018a1b03c7343d
lotus-gpu-miner-12.5.2-linux-x86_64.tar.gz2.8 MB8392e37a43d188cca8727293fe88e5d0ff32a8d1af89d9feb5a9b154e805a036

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

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