> For the complete documentation index, see [llms.txt](https://docs.mazze.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mazze.io/run-a-node/introduction-to-mazze-testnet.md).

# Run a node

Run a Mazze node and miner, and test wallets, RPC and mining against a live network.

This section is for node operators and testers: running a node and a miner, using the CLI and the RPC, and reading the logs.

{% hint style="info" %}
**Network cadence.** The operational target is **4 blocks per second**. Dev mode can run at other intervals (`dev_block_interval_ms`), so do not read dev-mode throughput as network throughput.
{% endhint %}

## Guides

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Setup guide</strong></td><td>A node and a miner with Docker Compose, or from source.</td><td><a href="/run-a-node/setup-guide.md">Setup guide</a></td></tr><tr><td><strong>Mazze CLI</strong></td><td>Wallets, transfers and chain summaries from the command line.</td><td><a href="/run-a-node/mazze-cli.md">Mazze CLI</a></td></tr><tr><td><strong>Mining</strong></td><td>The <code>stratum</code>, <code>cpu</code> and <code>disable</code> modes, and the RandomX miner.</td><td><a href="/run-a-node/mining.md">Mining guide</a></td></tr><tr><td><strong>RPC guide</strong></td><td>Ports, examples, safe exposure and the full method list.</td><td><a href="/run-a-node/rpc.md">RPC guide</a></td></tr><tr><td><strong>Viewing logs</strong></td><td>Where logs go and how to follow them.</td><td><a href="/run-a-node/viewing-logs.md">Viewing logs</a></td></tr><tr><td><strong>Soak test</strong></td><td>Sustained high-BPS load, with metrics for tuning.</td><td><a href="/run-a-node/soak-test.md">Soak test</a></td></tr></tbody></table>

## Before you upgrade

{% hint style="warning" %}
**Wipe local chain state** before you start a node built from the current code. The genesis block hash changed when the genesis transaction gained a message.
{% endhint %}

* The default state database is now MDBX. Set `state_db_type = "paritydb"` to keep using ParityDB.
* Logs go to the repository-root `logs/` directory.
* `public_rpc_apis` defaults to `"safe"`. Review `run/hydra.toml` before exposing RPC.

## What to test

* Running and validating node and miner infrastructure.
* Wallet and transfer workflows with the CLI.
* RPC integrations, native and eSpace.
* Mining modes: `stratum`, `cpu`, `disable`.
* Contract deployment on eSpace: see [Deploying smart contracts](/run-a-node/deploying-smart-contracts-on-mazze-testnet.md).

Found a problem? See [Feedback and reporting issues](/run-a-node/feedback-and-reporting-issues.md).