Skip to main content

Run a node

Running a node lets you mine — earn block rewards and mined storage by taking your turn in the PoA rotation. The easiest way is the Ombra Suite desktop app, which bundles a full node, wallet, miner, and the local AI runtime.

Option A — Ombra Suite (recommended)​

  1. Install the desktop app. On first launch it provisions the v1 genesis + fork heights automatically and starts syncing from the network.
  2. Mount a local model (the app downloads GGUF models for you) so your node can answer AI tasks.
  3. Register as a miner from the Mining panel — it emits MINER_REGISTER and you appear in the miner list.
  4. Once your ox address is in the network allowlist, you start getting proposer turns and earning.

The app shows live height, peers, your mined-storage bar, and the Ombra mind state.

Option B — headless miner-node​

For servers, run the @ombrachain/miner-node process. Key environment:

OMBRA_FORK_HEIGHT=1
OMBRA_FORK_HEIGHT_V6=1
OMBRA_FORK_HEIGHT_V7=1
OMBRA_FORK_HEIGHT_WEB=1
OMBRA_FORK_HEIGHT_V8=1            # Disc Minat
OMBRA_V7_PROPOSER_ALLOWLIST=ox…  # permissioned set (same on every node)
OMBRA_REQUIRE_PEERS=1            # don't produce solo (0 peers → 0 blocks)
Fork heights are read at startup

Core reads OMBRA_FORK_HEIGHT_* when the module loads. They must be set before the process starts (persistent env or the app's bootstrap), and must match across all nodes — they're consensus parameters.

How rewards work​

Each block you produce credits the block reward and +4096 B of storage capacity. Your node only produces when it has at least one peer, and only when it's your deterministic turn — so a small, healthy set of miners shares production fairly without forking.