Earth Node installer

Everything needed to turn a Linux machine into an Earth Node: hardware validation, then the node install itself. Ubuntu 24.04 is the reference platform.

Start here — claim your Testnet NFT

Admission to the public testnet is held by an EarthNode Testnet NFT. If you hold an EarthNode NFT, you mint one against it: the claim binds the EarthNode NFT you hold and the EVM address your node will run with.

  1. Connect the Cardano wallet holding your EarthNode NFT
  2. Pick which NFTs to claim against — at most two per wallet
  3. Verify your email, add a Discord handle if you want
  4. Give your EVM address, sign, and mint
Claim your Testnet NFT
Both NFTs must stay in that wallet. Eligibility is checked against the wallet holding them — move or sell either one and it lapses. The EVM address is written into the NFT's metadata, so run your node with that address.

What you need

Before you start the installer:

  1. An EarthNode Testnet NFT, claimed above
  2. A machine you control, with root access
  3. The wallet holding your Testnet NFT, to sign your download command on the claim page — the download is made for your claim: your installer carries it and is re-checked on chain
UbuntuDebianLinux Mint FedoraRHEL / Rocky / AlmaRaspbian

Windows and macOS are not supported — Earth Nodes run the supervisor/containerd model on Linux.

Installer downloads will be available soon!

Keep an eye on our Discord channel for the latest updates. As soon as the installer is ready, we'll make it available right here for you to download.

Stage 1 — validate the machine

Checks the hardware, collects location, and authenticates to the registry. It installs nothing permanent. Your download is built for your claim: the installer carries your Testnet NFT and claim transaction, so it only works for you — do not share it.

Create your download command on the claim page: connect the wallet holding your Testnet NFT and sign (free, moves no funds). It looks like this, and is single use and valid for 15 minutes:

curl -fsSL -o earthnode-stage1.sh \
  "https://start.testnet.wmnode.com/public/earthnode-stage1.sh?proof=…&sig=…&key=…"
sudo bash earthnode-stage1.sh

The download is gated: without a valid claim and a fresh wallet signature it returns 403, with the JSON telling you what is missing.

Never add -k or --insecure. This server has a normal, publicly trusted certificate. If curl reports a certificate error, stop — do not run what was downloaded, and report it.

Stage 2 — install the node

Stage 1 prints this at the end. It is the same file for every distribution.

curl -fsSL -o earthnode-phase2-linux.sh \
  "https://start.testnet.wmnode.com/public/earthnode-phase2-linux.sh"
sudo bash earthnode-phase2-linux.sh
If curl reports a certificate error, stop. Do not run what was downloaded, and report it.

Files

Served here, listed for reference. Stage 1 fetches what it needs on its own.

earthnode-stage1.sh
entry point — built per download for your claim
earthnode-phase2-linux.sh
the node installer
countries.json, regions.json
location data used during stage 1
ca/root-ca.pem
World Mobile root CA, sha256-pinned by the installer