Individuals

Developers

Institutions

News

09

Upgrading your Metal Node software

Before upgrading your node, it is recommended that you backup your files which are used to identify your node on the network. The steps are covered in Chapter 06. Securely back up staker.crt, staker.key, and signer.key. These files preserve your node identity and are required for a complete restore.

If you installed your node using the installer script before as seen in Chapter 05, to upgrade your node, just run the installer script again.

./metalgo-installer.sh

It will detect that you already have MetalGo installed:

MetalGo installer
———————
Preparing environment…
Found 64bit Intel/AMD architecture…
Found MetalGo systemd service already installed, switching to upgrade mode.
Stopping service…

It will upgrade your node to the latest stable release, restart the service automatically, and print version information. The exact version and commit will vary:

Node upgraded, starting service…
New node version:
metalgo/<VERSION> [network=mainnet, database=<DATABASE_VERSION>, commit=<COMMIT>]
Done!

And you are set! Your node is upgraded to the latest version! If you installed your node manually, proceed with verifying the official documentation.

For more information and assistance, you can always join the official Metal Blockchain Validator Telegram chat.

Before upgrading your node, it is recommended that you backup your files which are used to identify your node on the network. The steps are covered in Chapter 06. Securely back up staker.crt, staker.key, and signer.key. These files preserve your node identity and are required for a complete restore.

If you installed your node using the installer script before as seen in Chapter 05, to upgrade your node, just run the installer script again.

./metalgo-installer.sh

It will detect that you already have MetalGo installed:

MetalGo installer
———————
Preparing environment…
Found 64bit Intel/AMD architecture…
Found MetalGo systemd service already installed, switching to upgrade mode.
Stopping service…

It will upgrade your node to the latest stable release, restart the service automatically, and print version information. The exact version and commit will vary:

Node upgraded, starting service…
New node version:
metalgo/<VERSION> [network=mainnet, database=<DATABASE_VERSION>, commit=<COMMIT>]
Done!

And you are set! Your node is upgraded to the latest version! If you installed your node manually, proceed with verifying the official documentation.

For more information and assistance, you can always join the official Metal Blockchain Validator Telegram chat.

Metal Blockchain illustration

in support of Metal Blockchain.

© 2026 Metallicus, Inc. All rights reserved.

Metal Blockchain illustration

in support of Metal Blockchain.

© 2026 Metallicus, Inc. All rights reserved.

Metal Blockchain illustration

in support of Metal Blockchain.

© 2026 Metallicus, Inc. All rights reserved.