> For the complete documentation index, see [llms.txt](https://service.block-pro.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://service.block-pro.net/testnet/monad/node-upgrade.md).

# Node Upgrade

Upgrade Monad Testnet to v0.16.7, including the direct path from v0.16.5.

**Testnet · Chain ID `10143` · v0.16.7**

All Testnet operators can upgrade. **v0.16.5 → v0.16.7 is supported**, so operators on v0.16.5 can skip installing v0.16.6. This rolling upgrade keeps the existing `node.toml`. For releases older than v0.16.5, review the [earlier upgrade instructions](https://docs.monad.xyz/node-ops/upgrade-instructions) and complete the storage migrations required for your node.

## Check the installed release

Read the installed RPC tag to select your upgrade path.

```bash
monad-rpc -V
```

Custom launchers must pass the TrieDB block device to `--triedb-path`. Packaged units already use `/dev/triedb`. [TrieDB checks](https://service.block-pro.net/testnet/monad/useful-commands.md#triedb-configuration-checks)

## Refresh the APT signing key

If upgrading directly from **v0.16.5**, import the rotated Category Labs key before refreshing APT. Operators who already installed the rotated key for v0.16.6 can proceed to **Install v0.16.7**. [Official key instructions](https://docs.monad.xyz/node-ops/upgrade-instructions/v0.16.7#3-apt-repository-signing-key)

Download the official armored key into a temporary file. Keep the same shell open for the next two commands.

```bash
MONAD_APT_KEY=$(mktemp) &&
curl -fsSL https://pkg.category.xyz/keys/public-key.asc -o "$MONAD_APT_KEY"
```

Check that the signing key shows fingerprint `7C42 CFAB 84AB B23B 5040 082C DE2D ABCA 749E 2B10`.

```bash
gpg --show-keys --with-fingerprint "$MONAD_APT_KEY"
```

Once the fingerprint matches, install the key into the APT keyring referenced by the Category Labs repository.

```bash
sudo gpg --batch --yes --dearmor -o /etc/apt/keyrings/category-labs.gpg "$MONAD_APT_KEY" &&
rm -- "$MONAD_APT_KEY"
```

## Install v0.16.7

Refresh APT and resolve any repository errors before stopping the node.

```bash
sudo apt update
```

Stop consensus, execution and RPC.

```bash
sudo systemctl stop monad-bft monad-execution monad-rpc
```

Install the exact Testnet package, then restore the package hold.

```bash
sudo apt install monad=0.16.7 --allow-change-held-packages &&
sudo apt-mark hold monad
```

Reload the packaged units and start the node.

```bash
sudo systemctl daemon-reload &&
sudo systemctl start monad-bft monad-execution monad-rpc
```

## Verify the node

Check that all three services are active.

```bash
sudo systemctl status monad-bft monad-execution monad-rpc --no-pager -l
```

Confirm that the RPC binary reports tag `v0.16.7`.

```bash
monad-rpc -V
```

Once RPC is ready, run this twice and confirm the block height advances.

```bash
curl -fsS http://127.0.0.1:8080/ -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' | jq -er '.result'
```

## Binary snapshots

Use snapshot format v2 for a memory-bounded restore into a page-encoded TrieDB. Both the producer and the restore host need v0.16.7 or newer. Snapshot dumps default to v1, so producers must select `--snapshot-format v2` explicitly. Existing v0 and v1 files still load and can use more memory on page-encoded databases. [Snapshot commands and buffer sizing](https://docs.monad.xyz/node-ops/upgrade-instructions/v0.16.7#upgrade-notes)

[Monad upgrade instructions](https://docs.monad.xyz/node-ops/upgrade-instructions/v0.16.7) · [Release notes](https://docs.monad.xyz/developer-essentials/changelog/releases#v0-16-7) · [Earlier TrieDB requirements](https://docs.monad.xyz/node-ops/upgrade-instructions/v0.16.5)
