Run a node

Who this is for: operators who want to run their own Lumia infrastructure (a full RPC node, a validium node, or a DA light client) instead of relying on a public endpoint. By the end of this section you'll know which node type fits your use case, what hardware it needs, and where to go for setup and troubleshooting.

Read this first. This is the distinction that matters most on this page:

Run a Node (this section) is generic, self-run operator documentation. Nothing here has a price, a subscription, or a holder programme attached: you run the software on your own infrastructure and Lumia does not manage it for you. Pulse > HyperNodes is a different thing entirely: Lumia's commercial node product. If you're looking for that, go to /pulse/hypernodes.

Lumia's node model, briefly

Lumia Prism runs on a Polygon CDK validium stack. There is no validator set and no consensus vote: one sequencer produces blocks, and correctness is enforced cryptographically: ZK proofs, not social agreement. Every node type documented in this section is a read replica or verifier, not a block producer. That means you can run any number of them without coordinating with anyone, but none of them make you part of block production. Components that do produce blocks or settle proofs (the sequencer, the aggregator) require privileged, key-gated access that Lumia does not currently offer to self-run operators.

Node types

RPC node

A full execution node that syncs Lumia state and serves standard JSON-RPC reads and transaction submission. What most operators want: a dapp backend, an indexer, or your own low-latency endpoint instead of a public one.

Validium node

The validity-proving side of Lumia's architecture, and its relationship to the sequencer and to zkProvers. Read this before assuming it's a lighter version of the RPC node. It isn't.

DA light client

Verifies that batch data was actually made available without running a full node.

Before deploying any of these, check hardware requirements: minimums differ a lot between node types, and one of them needs considerably more than a typical VPS.

A note on ports vs. public endpoints

Running your own node exposes JSON-RPC on your own host: local ports you control and choose whether to publish. That is not the same thing as Lumia operating a public RPC/WSS endpoint for the network at large; the official public endpoint set lives in /reference/networks, and Lumia's public WSS endpoint is not yet confirmed there. Don't treat "my node has a WSS port open" as equivalent to "Lumia publishes a WSS endpoint." They're independent facts.