Upgrade a standalone server (TAR/ZIP)

This example shows how to upgrade or patch a v5.x standalone server from a TAR/ZIP. We recommend the use of Redhat or Debian package managers to install/upgrade Neo4j v5 because it simplifies this process.

It is recommended to read the following pages before continuing:

For critical systems, it is recommended to:

  • Backup your server(s), including databases, configuration, and encryption keys to avoid losing data in case of failure.

  • Perform the upgrade in a test environment.

The following example steps assume that the Neo4j v5.x has its binaries in its default location, while the /data and /conf folders are configured using the server.directories.data configuration setting and the environment variable NEO4J_CONF. This means you can replace the DBMS binaries without affecting the configuration and state.

You must be careful to not overwrite your data or config directories when you install the new version.

Upgrade steps

  1. Stop Neo4j v5.x.

    /neo4j-enterprise-5.x/bin/neo4j stop

  2. From Neo4j Download Center, download latest version, v5.y TAR or ZIP and unpack it.

  3. Start Neo4j v5.y:

    /neo4j-enterprise-5.Y/bin/neo4j start

Monitor the logs

The neo4j.log file contains information on how many steps the upgrade will involve and how far it has progressed. It is advisable to monitor this log.