THE xONE LAB Explore the performance record
xone.sh

Operations.

31 stories

Networks7 min read

xOne on Apothem vs net2040: what changes for an operator

Compare xOne on XDC Apothem and net2040: chain id, V2 switch block, bootnodes, state size, sync modes, --mine rules, quiet window and measured follower numbers.

Nov 15, 2026Read story
Sync7 min read

Choosing an xOne sync mode on XDC: a decision table

Pick full, snap, minimal or archive for an xOne node on XDC. One table maps your need to a mode, with measured datadir sizes and the flags of all four clients.

Nov 15, 2026Read story
Storage7 min read

How to plan disk space for an XDC node with xOne

Plan disk for an XDC node with xOne: the node's 2%, 3% and 1% free-space lines, the 15% alert, datadir sizes per sync mode, segment files and MDBX limits.

Nov 15, 2026Read story
Operations6 min read

Disk watermarks and block sealing: why a full disk stops xOne

Why a low disk stops block sealing in xOne on XDC: one gate for import and producer, the NoSpace second line, and what the four clients do at the exit line.

Nov 15, 2026Read story
Operations7 min read

Four XDC clients on one host: load and disk records

What xOne recorded with four XDC clients on one shared host: the 27-minute Python seat outage, load averages, disk lines and the memory cap, with sources.

Nov 15, 2026Read story
Operations3 min read

What a refused block leaves behind: xOne's invalid-block evidence

When xOneRS refuses an XDC block, it keeps the block and the error in a bounded evidence directory: what an entry holds, the 16-entry and 1 GiB bounds, limits.

Nov 15, 2026Read story
Sync7 min read

How to join net2040 with xOne: step-by-step guide

Join net2040, XDC chain 2040, with xOne: get the binary, pass a peer, start the node, check the head against a reference, resume, swap the binary, pick a mode.

Nov 15, 2026Read story
Measurement6 min read

Measuring an xOne node before and after a change with measure-node.sh

How ops/bench/measure-node.sh records RPC latency, block import times, disk I/O and memory of a running xOne node before and after a window, and only reads.

Nov 15, 2026Read story
Operations4 min read

One tracker for four XDC clients: how the hourly net2040 report works

How the hourly net2040 tracker on xOneRS issue 140 is built: one row per node, head and lag against the archive tip, the stats-board flag, and the mint column.

Nov 15, 2026Read story
Validator9 min read

How to run an XDC validator on net2040 with xOne

How to run an XDC validator on net2040 with xOne: follow the network, import a signer key, pass the mint gate, start the producer, and hand off the seat safely.

Nov 15, 2026Read story
Networking4 min read

Banning a peer by hand on xOne: admin_banPeer on XDC

How an xOneRS operator bans and unbans a peer by node id with admin_banPeer, how the ban differs from automatic reputation bans, and what it does not keep.

Nov 15, 2026Read story
Networking5 min read

How to check an xOne node's networking from another host

The xOneRS p2p live checks: advertised address and NAT, enode and peer probes, a discovery bootnode, the node allowlist and interop with other XDC clients.

Nov 15, 2026Read story
Networking4 min read

How xOne chooses and drops XDC peers: dial sample, score, bans

How an xOneRS node picks peers to dial from a seeded discovery sample, scores each peer's offences, bans a peer at 100 points, and where operator bans fit.

Nov 15, 2026Read story
Monitoring4 min read

Running xOne with Prometheus and Grafana in Docker Compose

How to start the xOneRS monitoring stack with Docker Compose: Prometheus, Grafana, node_exporter and an optional Alertmanager on loopback, and how to check it.

Nov 15, 2026Read story
Release6 min read

xOne release checklist: upgrade the four clients on XDC

Checklist for xOneRS, xOneTS, xOnePy and xOneC: find the release, check the file, upgrade followers first, prove the start, roll back, and see the open defects.

Nov 15, 2026Read story
RPC4 min read

Exposing xOne JSON-RPC safely on XDC: limits, namespaces, JWT

The xOneRS JSON-RPC limits an operator relies on: 100-item batches, 5 MiB bodies, -32005 rate limits, namespace lists and -32601, JWT, and subscriptions.

Nov 15, 2026Read story
Validator4 min read

Setting up an XDC validator key with xone-signer-setup.sh

How ops/xone-signer-setup.sh in xOneRS checks a keystore against its address, imports it only with --apply, runs a roles report and prints a commented line.

Nov 15, 2026Read story
Sync6 min read

How to bootstrap an XDC node from a snapshot with xOne

Export a snapshot from a synced xOne node, import it with a pins file, and start in minimal mode. Covers the checks, what the node keeps, and all four clients.

Nov 15, 2026Read story
Snapshot4 min read

Snapshot import with --staging: restore an xOne node safely

How xone snapshot import avoids a half-written XDC datadir: checks before any write, a resumable chunk buffer, --staging on another disk, head.json last.

Nov 15, 2026Read story
Operations7 min read

How to upgrade or roll back an xOne node safely

Upgrade or roll back an xOneRS node on XDC: check the binary, upgrade followers first, back up the datadir, and never lower or restore the signer safety record.

Nov 15, 2026Read story
Operations5 min read

How xOne refuses the wrong XDC network for a datadir

How xOneRS keeps a datadir on its own chain: the chain marker with chain id, genesis hash and consensus schedule, the --chainspec.update rule, and peer checks.

Nov 15, 2026Read story
RPC4 min read

Running an XDC RPC endpoint on xOne: a checklist for providers

A checklist for public XDC JSON-RPC on xOneRS: history and archive, limits, TLS and per-key method lists, health checks, log queries and what to monitor.

Nov 15, 2026Read story
Operations4 min read

The xOne CLI for XDC operators: attach, rpc check, wait-ready and more

What the xOneRS command line gives an operator next to a running node: xone attach, rpc check, wait-ready, sync-status, evm t8n and statetest, with exit codes.

Nov 15, 2026Read story
Storage6 min read

The xone db toolkit: inspect, check, repair and compare an XDC node's database

Every xone db subcommand in xOneRS, grouped by job: what each reads or writes, which ones are safe beside a running node, and which need the node stopped.

Nov 15, 2026Read story
Hardware9 min read

XDC node hardware and disk requirements for xOne

XDC node hardware requirements for xOne: no CPU or RAM sizing is published. Read the enforced limits, disk watermarks, and the memory and disk use measured.

Nov 15, 2026Read story
Storage5 min read

History retention in xOne: pruning bodies, receipts, logs and state, and backfill

The xOneRS --history flags: how long a node keeps bodies, receipts, logs, state and preimages, how to prune a stopped datadir, and backfill after snap sync.

Nov 15, 2026Read story
RPC4 min read

Serving HTTP and WebSocket JSON-RPC on one port with xOne

How xOneRS serves HTTP and WebSocket RPC on one port: when it shares the listener, what stays separate per protocol, the TLS rule, and one admin_stopWS caveat.

Nov 15, 2026Read story
Operations6 min read

xOne ops toolbox: ten host tools for XDC node operators

The xOne ops toolbox in xOneRS: ten host tools for XDC nodes. Each entry says what the tool does, whether it changes anything, and gives one example command.

Nov 15, 2026Read story
Operations4 min read

Installing xOne with Homebrew, Helm, Stereum, Eth Docker or WSL2

What each xOneRS package covers: a pinned Linuxbrew formula, a follower-only Helm chart, Stereum and Eth Docker service files, and the WSL2 guide, with limits.

Nov 15, 2026Read story
Operations4 min read

xone setup: a guided first XDC follower, in English, Hindi or Marathi

How the xOneRS guided setup plans a first follower node: the questions it asks, the dry run, the JSON-lines events for scripts, and Hindi and Marathi prompts.

Nov 15, 2026Read story
Release3 min read

From xOne v0.1.0 to main: what changes for an operator after upgrading

What an operator notices when moving an xOneRS node from the v0.1.0 release to a build of main: new defaults, new flags that stay off, and formats that change.

Nov 15, 2026Read story
Was this page helpful?

Feedback is public on GitHub and needs a GitHub account. Nothing is sent until you submit the issue there. Page: /blog/tags/operations/. Reviewed version: 14 November 2026.

YOUR NEXT STEP

Build your way.

Choose an implementation to see its source-based build recipe.

Use the pinned Rust toolchain and platform build prerequisites in the repository.

git clone https://github.com/XDCIndia/xOneRS.git
cd xOneRS
cargo build --locked --release -p xone
./target/release/xone --version

This recipe builds the client; it does not start a node. Mainnet operation is not yet qualified.

Open source guide