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
- Get the latest release.
- Install the latest release.
Step 1: get the latest release
- Start a shell session.
- 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.
- Source code
- Docker
- 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
- 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
- If you installed your full node using Docker, pull the latest release from Docker Hub (tagged with
latest
):
docker pull hathornetwork/hathor-core
Step 2: install the latest release
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.
- From source code
- Using Docker
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.
If you installed your full node using Docker, restart it as usual. To remember how, see Hathor full node installation section.
Task completed
Hathor team will notify node operators to upgrade their full nodes whenever we release a critical version.
What's next?
-
Full node pathway: to know how to operate this application.