Skip to main content

Upgrade Hathor core (full node)

Goal

This article will guide you through upgrading Hathor core (full node).

We advise operators to upgrade their full nodes whenever Hathor team releases a version with critical modification — i.e., those who address security issues or greatly alter the system's machinery. To follow such releases, see Hathor core release notes.

Requirement

Having a running version of Hathor core different from the latest one. To see the latest release, see Hathor core release notes.

Step-by-step

  1. Get the latest release.
  2. Install the latest release.

Step 1: get the latest release

  1. Start a shell session.
  2. Change the working directory to where you installed your full node — namely, hathor-core and database, docker-compose.yml and database, or just the database.
  1. If you installed your full node from source code, change the working directory (the one you chose to store the application) to its child hathor-core:
cd hathor-core
  1. Update the branch release with the leatest changes:
git fetch origin release && git switch release || git switch -c release --track origin/release && git pull origin release

Step 2: install the latest release

warning

Do not remove the full node's database. Otherwise, it will need to sync with the network from scratch. In other words, keep the directory containing the blockchain database intact — typically data.

If you are connecting your full node to the mainnet, do not remove file peer.json. You should never replace it.

If you installed your full node from source code, follow Install full node from source code from step 2, substep 5 onward to update the project dependencies and to restart your full node normally.

Task completed

Hathor team will notify node operators to upgrade their full nodes whenever we release a critical version.

What's next?