EASYNODE FOR BTX · GUIDE

Run a BTX node in 5 steps

No terminal, no config files. If you can install an app, you can run a full node.

1. 1

   Download and open

   Grab easyNode for BTX from the download buttons for your platform:

   Mac (Apple Silicon): open the .dmg and drag the app to Applications. It installs under the name easyBTX Node, so that is what you will see in Applications and in the paths below. The first time, right-click the app and choose Open. macOS asks once because the build is community-signed.
   Windows (x64): run the setup. SmartScreen warns because the installer is community-signed too: choose More info, then Run anyway.
   Linux (x86_64): make the AppImage executable and run it, or install the .deb with sudo apt install ./BTX-Node_0.6.5_amd64.deb.

   If macOS instead says easyBTX Node is “damaged” or “can’t be opened,” that’s just the download-quarantine flag on an unsigned app. Clear it once in Terminal (Applications → Utilities → Terminal), then open the app normally:

   xattr -dr com.apple.quarantine "/Applications/easyBTX Node.app"

   Copy

   That command only clears the “downloaded from the internet” tag; it doesn’t change the app. It’s safe.

   One honest warning before you start, for every platform. Each published build follows the chain up to a block and then stops. Which block depends on the build.

   Mac. The current build stops at block 199,299. BTX published a change to a difficulty rule at that height on 25 August 2026 and withdrew it two days later, and this build's engine still carries the withdrawn rule. Your coins are not affected. A node reads the chain, it does not hold your keys. Getting past that block needs a BTX release that is not out yet. It reaches the node page and the changelog the day it exists.

   Windows. The published Windows build is 0.6.6. Its bundled node engine predates the BTX consensus release of 17 August 2026, so your node syncs normally and then parks at block 191,713, or at 184,999 if it checks blocks on the processor rather than on qualifying graphics hardware. A Windows build with a newer engine is not published yet.

   Linux. The published Linux build is 0.6.5, with an engine from the same era, so your node parks at block 191,713 and stays there, or at 184,999 if it checks blocks on the processor rather than on qualifying graphics hardware, which most Linux machines do. Nothing you can set in the app changes that. The Linux build carrying the newer engine is not published yet, and we are not going to name a date for it.

   On any platform, the free BTX Node Guardian tells you which kind of stall you are looking at, whether the network is waiting or your own node is behind.

   Updates only reach the Mac app today. A Windows or Linux copy checks for a new version, finds nothing listed for its platform, and stays on the one you installed, without saying so. To move those to a newer build, come back to the node page and download it.

2. 2

   Click "Set up my node"

   The app checks your free disk space first (the full chain needs about 105 GB) and tells you before it starts, not after. One click begins the setup.

   
3. 3

   Watch it come alive

   The app downloads a checksum-verified snapshot of the blockchain (~450 MB), starts your node, and loads the snapshot. Your node is usable the same evening; the full history keeps filling in quietly in the background.

   
4. 4

   Green means helping

   When the orb turns green, your node is live: verifying blocks, relaying to peers, holding its own copy of the chain. The frequency line under the orb plays a gentle note each time a new block arrives.

   
5. 5

   Let it live in the corner

   Close the window; the node keeps running in your menu bar or system tray. Or press the compact button and keep just the little light on your desktop. Settings has two looks (a calm line or an energy pulse), launch-at-login, keep-awake, four colors, and one-click disk reclaim. Stop anytime; nothing is locked in.