Community · Validators

Run a Validator

qXRP Falcon Testnet · Network ID 1001 · Bond 1,000 FALCON · Faucet drip 2,000 FALCON

The network has 4 bonded validators live. You can add a fifth (or run a non-validating full node) using the flow below.

Step-by-step

01
Create a Falcon wallet
Open Wallet and create a passkey-secured wallet. Back up your falcon_secret.
02
Claim 2,000 FALCON from the faucet
Use Faucet (or Falcon wallet → Top up). One drip per day per IP/account is enough to fund bonding.
03
Copy the one-liner
Copy the install command below. Open Wallet first so --payout fills in automatically.
04
Run on Ubuntu 22.04/24.04
Paste into a VPS or spare PC with port 51235/TCP open (and outbound internet). Docker installs automatically. Image: qxrp/xrpld:btc-spv-v6 (Bitcoin SPV bridge).
05
Fund the validator address
The installer prints a NEW validator r-address. Send ≥1,100 FALCON there (from your wallet or another drip tomorrow).
06
Auto-bond + rewards
Installer polls until funded, submits ValidatorRegister + Bond(1000), and sets up hourly ClaimReward cron. Claim extras from Community → Rewards.

Open Wallet →Open Faucet →Claim rewards →

One-liner template

Loading wallet…

export QXRP_XRPLD_IMAGE=qxrp/xrpld:btc-spv-v6
curl -fsSL https://raw.githubusercontent.com/beartec-jpg/FalconLedger/c47f3d02fc05cb691ebe26a4a9b2de6347dd90da/bin/install/install-qxrp-validator.sh | bash -s -- \
  --payout rYourWalletAddress \
  --node-name my-falcon-node

Requirements

Ubuntu 22.04 or 24.04 (or Debian 12)
≥4 GB RAM, ≥40 GB disk
Port 51235/TCP reachable from the internet
≥1,100 FALCON on the validator address (2,000 FALCON faucet drip recommended)

Validator dashboard

After bootstrap, open http://<your-server-ip>:8080 in your browser. The bootstrap script prints your droplet IP at the end. Port 8080 must be open in your cloud firewall.

Shows server state, ledger height, peers, bond status, and composite score (auto-refreshes every 10s).

Useful commands

Run on your server. Replace <validator-r-address> and your public IP.

Dashboard URL

http://<your-server-ip>:8080

Browser only — IP alone is not enough; use port 8080. Open TCP 8080 in cloud firewall.

Dashboard health

curl -s http://127.0.0.1:8080/health

Bond log

tail -f /var/lib/falcon-validator/bond.log

Live logs

docker logs -f falcon-validator

Restart

cd /var/lib/falcon-validator && docker compose restart

Stop

cd /var/lib/falcon-validator && docker compose down

Node info

curl -s -X POST http://127.0.0.1:5005 -H 'Content-Type: application/json' -d '{"method":"server_info","params":[{}]}' | python3 -m json.tool

Validator balance