v0.15.1 Upgrade Instructions - Monad Documentation

These instructions are only applicable to mainnet. Testnet operators should remain on v0.15.0 until further notice.

Upgrade notes

v0.15.1 is a consensus-only patch on top of v0.15.0. It sets the mainnet activation round for the vote pace change and block reward update (MIP-12) at Round 89,758,000 (~Thu Jul 23, 10:30 AM EDT).

All mainnet nodes must be upgraded to v0.15.1 before Round 89,758,000. Nodes not on v0.15.1 at that round will not recognize the new block reward and will fall out of consensus.

DB migration required (existing nodes only): If upgrading from v0.14.5 or earlier, a one-time database metadata migration is required before starting services. See Step 4 for the exact command. Nodes already running v0.15.0 can skip Step 4.

1. SSH into the node as `root` user

2. Stop services

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

3. Upgrade monad package

If you encounter issues with the GPG signature (e.g. signatures were invalid), please renew the keys with the command below.

curl -fsSL https://pkg.category.xyz/keys/public-key.asc \
  | gpg --dearmor --yes -o /etc/apt/keyrings/category-labs.gpg

sudo apt update && sudo apt install --reinstall monad=0.15.1 -y --allow-downgrades --allow-change-held-packages
sudo apt-mark hold monad

The apt-mark hold monad command prevents the monad package from being upgraded automatically by apt-get upgrade. Without it, unattended system upgrades can install a newer version of monad that has not been approved for your network, causing version mismatch issues.

4. Run DB migration (existing nodes only)

This step is required for nodes upgrading from v0.14.5 or earlier. Nodes already running v0.15.0 can skip this step.If this step is skipped on an existing database, services will abort on startup with a log message indicating the upgrade is needed — no data corruption occurs. Run the migration and start again.

monad-mpt --storage /dev/triedb --upgrade

Expected output: the migration completes in under 1 second with no errors.

5. Start services and verify

sudo systemctl start monad-bft monad-execution monad-rpc
sudo systemctl status monad-bft monad-execution monad-rpc --no-pager -l

Expected output: All services should show Active: active (running)

6. Verify the correct version is running

monad-rpc -V

Expected output:

monad-rpc {"commit":"fb3328c2e...","tag":"v0.15.1","branch":"","modified":true}

​Upgrade notes

​1. SSH into the node as root user

​2. Stop services

​3. Upgrade monad package

​4. Run DB migration (existing nodes only)

​5. Start services and verify

​6. Verify the correct version is running

Upgrade notes

1. SSH into the node as `root` user

2. Stop services

3. Upgrade monad package

4. Run DB migration (existing nodes only)

5. Start services and verify

6. Verify the correct version is running