Upgrade IRI

Please use the tool iric in order to upgrade IRI’s version when a new release is out.

Latest IRI release is available here.

Sometimes it might take a while until the image is pushed to dockerhub, in which case you will see a release is already on Github but not yet available to upgrade your node. It normally takes a few minutes to get built and available on dockerhub.

If a new version has been announced, a new docker image for IRI should be made available and can be pulled via iric (upgrade IRI).


The foundation might announce additional information in tandem with upgrades, for example whether to use the --rescan flag, remove older database etc. If required, additional options can be specified under the OPTIONS="" value in the configuration file (/etc/default/iri for Ubuntu and Debian or /etc/sysconfig/iri for CentOS). The database folder is in /var/lib/iri/target/mainnetdb and can be removed using systemctl stop iri && rm -rf /var/lib/iri/target/mainnet*.

You can update IRI using the iric tool: Fullnode IRI Configuration Utility. Make sure that there are no additional manual steps to be taken if any are announced by the Foundation.

Upgrade IOTA Monitoring

IOTA Prometheus Monitoring is used by Grafana which are the awesome graphs about the full node.

You can update the monitoring using the iric tool: Fullnode IRI Configuration Utility.

Check Database Size

You can check the size of the database using du -hs /var/lib/iri/target/mainnetdb/, e.g.:

# du -hs /var/lib/iri/target/mainnetdb/
4.9G    /var/lib/iri/target/mainnetdb/


To check free space on the system’s partitions use df -h If one of the partitions’ usage exceeds 85% you should consider a cleanup. Don’t worry about the /boot partitition though.

Check Logs

Follow the last 50 lines of the log (iri):

journalctl -n 50 -f -u iri

For iota-pm:

journalctl -n 50 -f -u iota-pm

Click ‘Ctrl-C’ to stop following and return to the prompt.

Alternatively, omit the -f and use --no-pager to view the logs.

Replace Database

If you want to re-download a fully synced database please refer to Where can I get a fully synced database to help kick start my node on how to get this done.