EASYNODE FOR BTX · BY EASYBTX
easyNode for BTX.
Run a node. Support the network.
Every full node makes BTX harder to censor and easier to trust. easyNode turns "run a node" from an evening of terminal commands into one click, then sits quietly in your menu bar, doing its part.
Mac (Apple Silicon) · Windows (x64) · Linux (x86_64, deb too) · checksums (mac, Windows, Linux) · what's new. No mining, no account, wallet off by default.
Where things stand, 9 September 2026
The split, said plainly. On 5 September the network split at block 210,496 and our validator sat on the minority branch for twenty hours; it rejoined the live chain at 20:32 UTC after a 383-block reorganisation. The node engine's own peer rules kept it from the live chain's nodes, and we have reported that upstream. easyNode now shows when a longer chain exists that your node cannot obtain, follows the chain with the most work instead of parking, and carries a seed that is on the live chain. Which chain any reachable node follows is measured on the node census.
Mac. easyNode 0.6.23 is the current Mac build, released 15 September, and all three platforms ride node-v0.6.23. It carries the same BTX 0.34.6 engine as the Linux and Windows builds, from the same commit, built from a pristine tree and smoked before it was packaged. 0.6.22 and 0.6.23 shipped for Linux and Windows first, so for part of 15 September a Mac was offered nothing by the updater; that gap is closed, and a Mac from 0.6.0 onward is offered 0.6.23. It brings the peering work described above, the corrected fork warning, the config lock, the role the node actually fills, and a log of every self-update check. The build before 0.6.17, 0.6.12, stopped at block 199,299 and could not start again on its own: BTX published a change to a difficulty rule at that height on 25 August and withdrew it two days later, and 0.6.12 still carried the withdrawn rule. Updating is what starts such a Mac again.
Your coins are not affected. A node reads the chain, it does not hold your keys. What is out of date is your node's view of the chain, not your balance.
What a Mac does on this network, said plainly. An Apple Silicon Mac proves the block maths on its own GPU and validates as a full consensus node. We measured that on this release on an Apple M5: the engine qualified the GPU at startup with no fall back to the processor, and the node advertised itself as a consensus validator. A Mac that has been off for days does not rejoin instantly. It restarts from the small verified snapshot the app carries and then backfills, and how long that takes depends far more on which peers serve it blocks than on how fast the Mac is.
Updating a Mac that has been stopped for a week is not instant. The update refreshes the small verified snapshot it carries, at height 203,000, so your node rejoins near the tip rather than replaying the fork, and then it backfills the rest. Expect hours rather than minutes, and on a Mac that has been off since the split expect longer than that: our own Mac was catching up at roughly two blocks a minute on 6 September. Leave it running, and keep the wallet closed while it catches up: reading a balance mid catch up slows validation down. The app says where it is on the status screen the whole time.
Linux. easyNode 0.6.23 for Linux is live: released
15 September, and installed AppImage copies from 0.6.0 onward update
themselves through the app's own check. Since 0.6.22 it tells you when
its own newest block is more than two hours old, a signal that a stuck
set of peers cannot fake, and it stops describing a node that holds a
signing key as an archive serving history. 0.6.23 moves the engine to
BTX's tagged 0.34.6, shows which role your node fills and whether that
helps other nodes, and writes every self-update check to a log. A .deb install is
told a new version exists and is updated by hand. Its engine is
BTX 0.34.6, built by us from the BTX source because the BTX Linux
binaries need a newer glibc than Ubuntu LTS carries. It tells you in
amber when a longer chain exists that it cannot obtain, and it follows
the chain with the most work. 0.6.20 added a switch worth turning on:
your node can answer one question for wallets, which block sits at a
given height. That is how a wallet checks it is on the right chain, it
costs almost nothing, and it works on a node of any size, because it
reads the list of blocks rather than the blocks themselves. It answers
that and refuses every other question. With a suitable NVIDIA card (verified here on an RTX 3060)
the node proves itself at startup and validates blocks as a full
consensus validator. Without one, since 0.6.23, the node runs as a
trusted mirror: it follows the chain the network's validators have
signed and serves history to other nodes, which is what the explorer
is shortest of, but it does not check the block maths itself and it
trusts the pinned signing keys to have done so. Earlier builds on such
a machine started, synced headers, and stalled. The download is large,
about 466 MB, because the engine and its GPU math library travel
inside the app.
Why the engine changed, said plainly. The previous
engine, v0.34.5, could not keep up on our Linux hardware: measured on
one machine with the same data and only the binary changed, it
connected 0.68 blocks a minute against a chain producing 0.95, so a
node on it fell behind for good while reporting itself healthy. The
0.34.6 engine did 3.80 on the same machine and has run on our own
validator since 2 September. 0.6.18 through 0.6.22 bundled their
release/0.34.6 branch at commit 9eb4e005.
BTX tagged 0.34.6 on 13 September at 3013c2c2, one commit
past that build: the commit stops counting a peer that only sent
headers as a source of block bodies and changes no consensus rule.
0.6.23 moves to that tagged commit, built from a pristine tree by our
own CI, and both of our engine checks verify that exact commit. The
engine lands on its own with the app update: the install directory
carries the commit, so no copy can keep the old build by mistake. An
AppImage applies it on its own; a .deb install is told
and updated by hand. The Windows build carries the same engine commit,
built separately on its own platform; the Mac build stays one commit
behind until its 0.6.23 is made. The blocks a minute above were
measured on Linux hardware and we have not repeated that measurement
elsewhere.
Windows. There is a native Windows build again:
0.6.23. 0.6.21 was the first since 0.6.6, and
0.6.23 follows it with BTX's tagged 0.34.6 engine, the same commit
Linux carries. Upstream still publishes no Windows
binaries at all, so we cross-compile that engine ourselves and smoke it
on a real Windows machine before it ships. Copies on 0.6.6 are offered
this one directly — they have always used the working feed — and that
matters, because 0.6.6's engine predates the 17 August consensus
release and parks at block 191,713, or at 184,999 on a machine that
checks blocks on the processor. If you have a Windows node sitting at
one of those heights, this is what starts it again.
The WSL2 route is still there and still good: the Linux build under
WSL2, the same way the easyBTX miner has run on Windows since July.
That is the setup we verified 0.6.17 on — a Windows machine, WSL2, and
an RTX 3060, where the node qualifies its own GPU and validates as a
full consensus validator. The
five minute setup is in the guide.
Which you pick depends on your card: the native build has not been
measured against a GPU here, and WSL2 has.
Ask your node about the chain and get cited answers from your own verified copy. The green dot means it came from your machine, not a website.
How to set it up, in 5 steps → What changed in each version →
An optional wallet, off by default
Turn it on in Settings, then create a post-quantum BTX wallet or import your .btxwallet file. Send and receive BTX, watch confirmations arrive live, and hear a quiet coin when a payment lands. Balances and history are answered by your own node, never a public explorer, and nothing leaves your computer except a transaction you choose to broadcast.
Why run a node?
Decentralization is people
A chain is only as independent as the number of people who verify it themselves. Your node checks every block against the rules on your own machine, not against anyone's server. BTX also requires one proof that needs a suitable GPU; a machine that can run it does, and a machine that cannot uses signed confirmations from operators who did. Your node tells you which one it is doing.
BTX is young
The network is small and growing. Right now, each additional node meaningfully strengthens it. This is the moment where one person still moves the needle.
Quietly useful
Your node relays blocks and transactions to other peers, helps new nodes bootstrap, and keeps an independent copy of the chain's history alive.
How it works
- 1
One click to set up
The app downloads a checksum-verified snapshot of the blockchain and starts a full node. Ready the same evening, not next week. The full history backfills in the background.
- 2
It looks after itself
Close the window and it asks whether to keep the node running in your menu bar or quit. It can keep your computer awake, start at login, keep itself up to date, and shows a calm live status: block height, peers, uptime, disk.
- 3
Stop anytime
One click stops the node cleanly. Your disk space is yours. The app shows exactly what the chain uses and can reclaim data the node no longer needs.
Send, receive, and how updates reach you
The optional wallet sends and receives BTX straight from your node. Watch confirmations tick up live, and hear a quiet coin when a payment lands or clears. A running node reads LIVE at a glance, money in shows green and money out shows red, and closing the window asks whether to keep the node in your menu bar or quit.
The app updates itself on Mac, Linux and Windows, and a Windows machine running it under WSL2 updates like Linux. A copy checks for a new version, verifies its signature, and installs it on the next relaunch. Any platform not named there checks the same place, finds nothing listed for it, and quietly stays on the version you installed — which is the safe outcome, not a fault: it already has the build we meant it to have.
One exception on Linux: a .deb install is told, not
updated. The updater can only install an AppImage, so a
.deb copy sees the new version and says so, and you install
it by hand with the command on this page. The AppImage updates itself.
Still one calm app on macOS, Windows, and Linux. Each platform's node is built from the official BTX source and boot-tested before it is allowed into the installer, including mining a test block.
Following the chain across the 2026 consensus changes
BTX changed how blocks are proven at height 185,000 on 10 August 2026, and added a difficulty floor at height 191,714 on 17 August. Both changes are done and the network moved on. A node whose engine was built before one of those lines reads everything past it as invalid, so it parks one block below and keeps looking perfectly healthy. That is why an old build sits at 184,999 or at 191,713 and never moves again.
The Mac build crosses both of those lines. Its engine is built here from the official BTX source, so a Mac node parked at 184,999 or at 191,713 is fixed by updating, and nothing on disk needs downloading again.
A third line, at block 199,299, took longer to cross. BTX published a difficulty rule change at that height on 25 August 2026 and withdrew it on 27 August, and every build up to Mac 0.6.12 still carried the withdrawn rule, so those nodes stop at that block. BTX released the fix, v0.34.5, on 30 August. The Mac and Linux builds on this page both bundle its successor, 0.34.6, which carries the same fix, so updating crosses this line too. Your coins were never affected either way. A node reads the chain, it does not hold your keys.
Every current build crosses all three lines. easyNode 0.6.23 bundles BTX's tagged 0.34.6 on Mac, Linux and Windows alike, from one commit; it carries none of them. On a machine with a suitable NVIDIA card the node qualifies itself at startup and validates blocks; without one, 0.6.23 runs it as a trusted mirror that follows the signed chain and serves history rather than stalling. On Windows you can run the native 0.6.23 build or the Linux build under WSL2, with the same rule either way. A Windows copy still on 0.6.6 carries an engine from before the 17 August release, so it stops at 191,713, or at 184,999 on a machine that checks blocks on its processor — updating is what moves it.
Keeper mode has been built in on Mac since 0.6.8. One switch in Settings turns your node into a small pruned one, roughly 10 GB of disk instead of about 124 GiB, that serves the short signed confirmations other machines use to follow the chain. Those confirmations are the scarcest thing on this network. There is a longer write-up on the Keeper page, including the standalone macOS installer if you would rather run Keeper on its own.
Re-checking the new proofs by replaying the work still needs qualifying hardware, and that is the node software's rule, not ours. A Block checking line on the status screen names which mode your machine is in, so a node that is following along on signed confirmations rather than replaying proofs says so plainly instead of leaving you to guess.
If your node has stopped at a block and stays there, the block number tells you which case you are in. 184,999 or 191,713 means an engine from before 17 August. 199,299 means the withdrawn rule described above. In every case the fix is the same now: the builds on this page cross all three lines, on Mac, on Linux, and on Windows under WSL2. The free BTX Node Guardian tells you which case you are in on any BTX node, on any machine: whether the network is waiting or your node is behind.
Ask your node anything about BTX
Tap the ? in the header and your node answers the questions people usually ask an explorer website: how far along the chain is, how much BTX exists so far, when the next halving lands, what fees look like, how hard mining is right now, and any block you point it at. Every answer carries a small pill naming the exact source, and the green dot means one thing: this came from your own verified copy of the chain, not from someone else's server.
Explorer mode
Want to look up old transactions? Turn on Explorer mode and your node builds a transaction index in the background. It keeps running while it builds, and the switch works both ways.
Optional wallet
Off by default. Flip one switch in Settings, create a wallet or import the file from the official BTX browser wallet, then send and receive with balances from your own node, no explorer in the middle.
Cleans up after itself
The app removes data the node no longer needs automatically, every time it starts, the same housekeeping habit the easyBTX miner is known for. No slow disk creep.
The honest part
- Disk: a full node keeps every block. The chain measured about 124 GiB of blocks on 4 September 2026, and the app asks for 140 GiB free before it starts so the sync can finish. Growth is small now: the proof-of-work change at block 185,000 ended the era of million-byte blocks, and the measured average since 10 August is 8.4 kB a block, about 8 MB a day rather than the 1 GB a day this page used to claim. The app warns you early, not after, and can remove the chain data again in one click.
- Bandwidth: a one-time snapshot download at setup (9.3 MB on the newest builds, ~450 MB on older ones), then normal peer-to-peer traffic. The Linux app itself is a large download, about 466 MB, because the engine and its GPU math library travel inside it.
- No rewards: BTX has no node incentive today. This one is for the network, not for a payout. If that changes, this app is where it will land first.
- Your machine, your keys, your data: the wallet view ships switched off; if you turn it on, balances are read from your own node and nothing leaves your computer except normal node traffic.
We measured the real cost on an ordinary Mac: about as much power as an LED bulb.
Your node matters more than it used to
Most machines now follow the chain using small signed confirmations passed from node to node, and the network is chronically short of nodes that serve them. Both halves of that have shipped on Mac. Since 0.6.7 the app reads its own node's signals and names why a chain is stuck, then re-dials the known archive peers itself rather than restarting anything. Since 0.6.8 the engine can serve those confirmations, which is the same job BTX Keeper does on Apple-silicon Macs with one command. Same engine, two ways to help.
The live node map shows how thin that layer still is. A census on 22 August 2026 counted 65 live nodes, 30 of them at the tip, with 12 verified archives between them.
Running a BTX node that is not ours at all, on any machine? The BTX Node Guardian is the stall logic from this app as a standalone script, free and open. It watches and reports, and it never restarts your node.
Built on proven parts
easyNode for BTX runs the same node engine as the easyBTX miner, the code that has been starting, watching, and healing BTX nodes on real Macs since the chain's early days. Same fast-start, same careful shutdowns, same disk care. Two ways to take part: mine with the miner, or verify with the node. Many people do both.
Where this is going: this app is the foundation for future ways to support the network, and if the network ever rewards node operators, this app is where that lands first. No promises, just the plan. First: the best one-click node we can build.
Be one of the nodes
A chain is as strong as the people who verify it. We would love to see thousands of independent BTX nodes, and each one starts with a single person deciding theirs should exist.