Quickstart - XOXNO Docs

Install mxnode, create a MultiversX node shape, start services, and verify that systemd units are running.

Prerequisites

Requirement	Value
Host	Linux with systemd
CLI install	`curl -fsSL https://raw.githubusercontent.com/XOXNO/mx-node/main/install.sh \| sh`
Multikey keys	`~/VALIDATOR_KEYS/allValidatorsKeys.pem`
Validator keys	One `node-{i}.zip` per validator node
Observer keys	None; observers generate throwaway BLS keys

Validator and multikey flows use live BLS signing keys. Verify backups, file ownership, and host access before starting services.

curl -fsSL https://raw.githubusercontent.com/XOXNO/mx-node/main/install.sh | sh
mxnode --version

For a multikey host:

mkdir -p ~/VALIDATOR_KEYS
cp /path/to/allValidatorsKeys.pem ~/VALIDATOR_KEYS/

For a validator host, place node-0.zip, node-1.zip, and so on in ~/VALIDATOR_KEYS/.

Choose one:

Shape	Command
Multikey squad	`mxnode install --role multikey`
Single validator	`mxnode install --role validator`
Observer squad with proxy	`mxnode install --role observer --squad --with-proxy`
Multikey backup host	`mxnode install --role multikey --backup`

A multikey install creates four nodes, one per shard.

mxnode start --all
mxnode status

Use one node when testing a targeted change:

mxnode start --node 0
mxnode logs --node 0

You have a valid quickstart result when:

Symptom	Cause	Fix
Missing key error	Key file is not in `~/VALIDATOR_KEYS/` or has the wrong name.	Move the key file and rerun install.
`--role multikey --count` rejected	Multikey shape is fixed at four nodes.	Remove `--count`.
Unit restarts repeatedly	Config, port, or binary issue.	Run `mxnode logs --node <n>` and `mxnode doctor`.
Proxy installed with signing keys	Public RPC and validator signing share a host.	Put proxy on observer hosts, not multikey hosts.