Devnet Installation Commands

This document contains example installation commands for a multi-node devnet cluster.

Wallet: <YOUR_WALLET_ADDRESS> Contact: @anon: <YOUR_WALLET_ADDRESS>

Node Configuration

Node	Role	Nameserver	Anyone Relay
ns1	Genesis	Yes	No
ns2	Nameserver	Yes	Yes (relay-1)
ns3	Nameserver	Yes	Yes (relay-2)
node4	Worker	No	Yes (relay-3)
node5	Worker	No	Yes (relay-4)
node6	Worker	No	No

Note: Store credentials securely (not in version control).

MyFamily Fingerprints

If running multiple Anyone relays, configure MyFamily with all your relay fingerprints:

<FINGERPRINT_1>,<FINGERPRINT_2>,<FINGERPRINT_3>,...

Installation Order

Install nodes one at a time, waiting for each to complete before starting the next:

ns1 (genesis, no Anyone relay)
ns2 (nameserver + relay)
ns3 (nameserver + relay)
node4 (non-nameserver + relay)
node5 (non-nameserver + relay)
node6 (non-nameserver, no relay)

ns1 - Genesis Node (No Anyone Relay)

# SSH: <user>@<ns1-ip>

sudo orama node install \
  --vps-ip <ns1-ip> \
  --domain <your-domain.com> \
  --base-domain <your-domain.com> \
  --nameserver

After ns1 is installed, generate invite tokens:

sudo orama node invite --expiry 24h

ns2 - Nameserver + Relay

# SSH: <user>@<ns2-ip>

sudo orama node install \
  --join http://<ns1-ip> --token <TOKEN> \
  --vps-ip <ns2-ip> \
  --domain <your-domain.com> \
  --base-domain <your-domain.com> \
  --nameserver \
  --anyone-relay --anyone-migrate \
  --anyone-nickname <relay-name> \
  --anyone-wallet <wallet-address> \
  --anyone-contact "<contact-info>" \
  --anyone-family "<fingerprint1>,<fingerprint2>,..."

ns3 - Nameserver + Relay

# SSH: <user>@<ns3-ip>

sudo orama node install \
  --join http://<ns1-ip> --token <TOKEN> \
  --vps-ip <ns3-ip> \
  --domain <your-domain.com> \
  --base-domain <your-domain.com> \
  --nameserver \
  --anyone-relay --anyone-migrate \
  --anyone-nickname <relay-name> \
  --anyone-wallet <wallet-address> \
  --anyone-contact "<contact-info>" \
  --anyone-family "<fingerprint1>,<fingerprint2>,..."

node4 - Non-Nameserver + Relay

Domain is auto-generated (e.g., node-a3f8k2.<your-domain.com>). No --domain flag needed.

# SSH: <user>@<node4-ip>

sudo orama node install \
  --join http://<ns1-ip> --token <TOKEN> \
  --vps-ip <node4-ip> \
  --base-domain <your-domain.com> \
  --anyone-relay --anyone-migrate \
  --anyone-nickname <relay-name> \
  --anyone-wallet <wallet-address> \
  --anyone-contact "<contact-info>" \
  --anyone-family "<fingerprint1>,<fingerprint2>,..."

node5 - Non-Nameserver + Relay

# SSH: <user>@<node5-ip>

sudo orama node install \
  --join http://<ns1-ip> --token <TOKEN> \
  --vps-ip <node5-ip> \
  --base-domain <your-domain.com> \
  --anyone-relay --anyone-migrate \
  --anyone-nickname <relay-name> \
  --anyone-wallet <wallet-address> \
  --anyone-contact "<contact-info>" \
  --anyone-family "<fingerprint1>,<fingerprint2>,..."

node6 - Non-Nameserver (No Anyone Relay)

# SSH: <user>@<node6-ip>

sudo orama node install \
  --join http://<ns1-ip> --token <TOKEN> \
  --vps-ip <node6-ip> \
  --base-domain <your-domain.com>

Verification

After all nodes are installed, verify cluster health:

# Full cluster report (from local machine)
./bin/orama monitor report --env devnet

# Single node health
./bin/orama monitor report --env devnet --node <ip>

# Or manually from any VPS:
curl -s http://localhost:5001/status | jq -r '.store.raft.state, .store.raft.num_peers'
curl -s http://localhost:6001/health
systemctl status orama-anyone-relay

3.7 KiB Raw Blame History