Install TSUNAGI Node

A — What this release is

A qualified Preview release, in follower mode

TSUNAGI is an independent Cardano node implementation written in Zig. This release is its Cardano Preview release, running in follower mode, built for any x86-64 Linux machine. It is qualified for:

generic x86-64 baseline CPUs (SSE2) — no AVX, AVX2 or AVX-512 requirement
clean startup from an empty home directory
Preview ChainSync and BlockFetch
transaction decoding and application
local-state persistence, cold reopen and restart

It is not qualified for block production, stake-pool operation, Cardano Mainnet, production-grade operation, or Node V1 completion. TSUNAGI's canonical Preview blocks are produced by a separate producer build; this follower is not that binary.

B — Requirements

Before you start

64-bit x86 Linux with glibc 2.34 or newer (for example Ubuntu 22.04+, Debian 12+)
dynamic loader at /lib64/ld-linux-x86-64.so.2
runtime libraries providing liblmdb.so.0 and libsodium.so.23
network access to a Cardano Preview peer

# Debian / Ubuntu package names; any package providing the exact SONAMEs works
sudo apt install liblmdb0 libsodium23

C — Download and verify

Check the SHA-256 before running anything

curl -LO https://github.com/cryptoleo79/tsunagi-preview/releases/download/v2026.10.05-preview-portable-x86_64/tsunagi-preview-v2026.10.05-linux-x86_64
curl -LO https://github.com/cryptoleo79/tsunagi-preview/releases/download/v2026.10.05-preview-portable-x86_64/SHA256SUMS
sha256sum --check SHA256SUMS

Expected SHA-256: 4919985711adbf8f59b07839752e605ac3d98d1df35a42f5f93ab2ff3985e08e (5,798,056 bytes).

D — Install

Install and confirm the embedded identity

mkdir -p "$HOME/.local/bin"
install -m 0755 tsunagi-preview-v2026.10.05-linux-x86_64 "$HOME/.local/bin/tsunagi-node"
"$HOME/.local/bin/tsunagi-node" --version

Expected: tsunagi-node v2026.10.05-preview-portable-x86_64 (4cdcde42d5cd5f097e50bf5212db671b25ee6947) ReleaseSafe x86_64-linux-gnu … dirty=0

E — Run

Start from an empty state directory

Choose an empty directory that is not shared with another TSUNAGI process:

export TSUNAGI_HOME="$HOME/.local/state/tsunagi-preview"
mkdir -p "$TSUNAGI_HOME"
TSUNAGI_FORGE_ENABLE=0 "$HOME/.local/bin/tsunagi-node" run \
  --net preview \
  --lang en \
  --peer PREVIEW_PEER_HOST:PORT

Replace PREVIEW_PEER_HOST:PORT with a reachable Cardano Preview relay, for example the public relay preview-node.play.dev.cardano.org:3001.

Stop with Ctrl-C. Running the same command again reopens the generated cursor and local state.
Do not point this binary at another node's state directory.

F — Provenance

What was built, from what

Release page — release notes and assets
INSTALL.md — the qualified install instructions this page follows
PROVENANCE-MANIFEST.md — exact source commit and tree, toolchain hash, build flags, runtime dependencies
Source — private during active development; the release records its exact source commit (4cdcde42…, clean tree) in the provenance manifest