Red Hat, CentOS, Fedora, and Amazon Linux (.rpm)

You can deploy Neo4j on Red Hat, CentOS, Fedora, or Amazon Linux distributions using the Neo4j RPM package.

Java prerequisites

Neo4j 2025.x requires the Java 21 runtime (default). Starting with Neo4j 2025.10, Java 25 is also supported.

OpenJDK Java 21

Most of the supported Linux distributions have OpenJDK Java 21 available by default. Consequently, no extra setup is required if you are using OpenJDK Java, the correct Java dependency will be installed by the package manager when installing Neo4j.

Zulu JDK 21 or Corretto 21

If you want to use a non-default JDK, it must be installed before starting the Neo4j installation. Otherwise, your package manager installs the default Java distribution for your operating system, usually OpenJDK.

Installation instructions can be found on the manufacturer’s website:

Install on Red Hat, CentOS or Amazon Linux

Set up the repository

Import the Neo4j GPG public key into the system’s RPM keyring. The key is required to verify the authenticity of the Neo4j packages you will install.
```
rpm --import https://debian.neo4j.com/neotechnology.gpg.key
```
Create a neo4j.repo file in the /etc/yum.repos.d/ directory. This file contains the repository configuration for Neo4j.
```
cat <<EOF > /etc/yum.repos.d/neo4j.repo
[neo4j]
name=Neo4j RPM Repository
baseurl=https://yum.neo4j.com/stable/latest
enabled=1
gpgcheck=1
EOF
```
If you are upgrading from Neo4j 5.x or earlier, you may need to clear the package manager cache before Neo4j packages become available:

yum clean dbcache
Verify that the Neo4j repository is set up correctly by listing the available Neo4j packages versions:
```
yum list neo4j --showduplicates
```

Install Neo4j

Install Neo4j as root using the following commands depending on which edition you are using:

Neo4j Community Edition
```
yum install neo4j-2025.10.0
```
Neo4j Enterprise Edition

Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition. The following are examples of using an interactive prompt and a non-interactive installation:
Interactive installation of Enterprise Edition under the commercial license
```
yum install neo4j-enterprise-2025.10.0
```
You have to choose either a commercial license or an evaluation license before the interactive installation is allowed to complete.

For a non-interactive installation, you can set the environment variable NEO4J_ACCEPT_LICENSE_AGREEMENT to yes (for the commercial license) or eval (for the evaluation license). This should be done in the same line as the package is installed, to ensure bash correctly passes the environment variable to the installer process. As in the following example:
Non-interactive installation of Enterprise Edition under the commercial license
```
NEO4J_ACCEPT_LICENSE_AGREEMENT=yes yum install neo4j-enterprise-2025.10.0
```

Install on SUSE

For SUSE-based distributions, the steps are as follows:

Use the following as root to add the repository:

zypper addrepo --refresh https://yum.neo4j.com/stable/latest neo4j-repository

Install Neo4j as root using the following commands depending on which edition you are using:
- Community Edition
  zypper install neo4j-2025.10.0
- Enterprise Edition
  
  Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition. The following are examples of using an interactive prompt and a non-interactive installation:
  Interactive installation of Enterprise Edition under the commercial license
  zypper install neo4j-enterprise-2025.10.0
  You have to choose either a commercial license or an evaluation license before the interactive installation is allowed to complete.
  
  For a non-interactive installation, you can set the NEO4J_ACCEPT_LICENSE_AGREEMENT to yes (for the commercial license) or eval (for the evaluation license) as in the following example:
  Non-interactive installation of Enterprise Edition under the commercial license
  NEO4J_ACCEPT_LICENSE_AGREEMENT=yes zypper install neo4j-enterprise-2025.10.0

Offline installation

If you cannot reach https://yum.neo4j.com/stable/2025.10 to install Neo4j using RPM, perhaps due to a firewall, you need to obtain Neo4j via an alternative machine that has the relevant access, and then move the RPM package manually.

It is important to note that using this method means that the offline machine cannot receive the dependencies that are normally downloaded and installed automatically when using yum for installing Neo4j, Neo4j Cypher Shell, and Java.

Download the Neo4j and Cypher Shell RPM installers from Deployment Center or run the following to obtain the required packages:

Cypher Shell:

curl -O https://dist.neo4j.org/cypher-shell/cypher-shell-2025.10.0-1.noarch.rpm

Neo4j Community Edition:

curl -O https://dist.neo4j.org/rpm/neo4j-2025.10.0-1.noarch.rpm

Neo4j Enterprise Edition:

curl -O https://dist.neo4j.org/rpm/neo4j-enterprise-2025.10.0-1.noarch.rpm

Manually move the downloaded RPM packages to the offline machine. Before installing Neo4j, you must manually install the required Java 21 packages.

Install Neo4j and Cypher Shell as root using the following command depending on which edition you are using:

If you are upgrading from Neo4j 5.x or earlier, due to strict dependencies between Neo4j and Cypher Shell both packages must be upgraded simultaneously. This must be one single command, and Neo4j Cypher Shell must be the first package in the command.

Neo4j Community Edition

rpm --install cypher-shell-2025.10.0-1.noarch.rpm neo4j-2025.10.0-1.noarch.rpm

Neo4j Enterprise Edition

Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition. The following example uses an interactive prompt:
```
rpm --install cypher-shell-2025.10.0-1.noarch.rpm neo4j-enterprise-2025.10.0-1.noarch.rpm
```
You have to choose either a commercial license or an evaluation license before the interactive installation is allowed to complete. For a non-interactive installation, you can set the NEO4J_ACCEPT_LICENSE_AGREEMENT to yes (for the commercial license) or eval (for the evaluation license) as in the following example:
```
NEO4J_ACCEPT_LICENSE_AGREEMENT=yes rpm --install cypher-shell-2025.10.0-1.noarch.rpm neo4j-enterprise-2025.10.0-1.noarch.rpm
```

Start the Neo4j service automatically on system start

To enable Neo4j to start automatically on system boot, run the following command:

systemctl enable neo4j

Before starting up the database for the first time, it is recommended to use the set-initial-password command of neo4j-admin to define the password for the native user neo4j.

If the password is not set explicitly using this method, it will be set to the default password neo4j. In that case, you will be prompted to change the default password at first login.

For more information, see Set an initial password.

For more information on operating the Neo4j system service, see Neo4j system service.

Access Neo4j

By default, Neo4j Community Edition does not include graph tools such as visualization, data exploration, and monitoring. However, you can use the Neo4j Aura console to access these features for free. No subscription is required.

Sign up or log in to the Aura Console.
On the Instances page, click the Self-managed tab and then + Add deployment button.
Select URL Connection.
Provide a Name and Connection URL. If you have installed Neo4j locally on your system, you can connect to http://localhost:7474.
Click the Connect dropdown to launch various graph tools such as Query, Explore, and Dashboards.
Type the username neo4j and your password or the default password neo4j. You will be prompted to change the latter upon first login.

You are now connected and can use the Aura Console to run Cypher queries, visualize graphs, and optionally monitor your local Neo4j database in Neo4j Aura. For details, see Get started with Neo4j.

Alternatively, you can use the Neo4j Browser, a web-based user interface for interacting with Neo4j that is included with the Neo4j installation. To access the Neo4j Browser, open a web browser and navigate to http://localhost:7474. Connect using the username neo4j with your password or the default password neo4j. If the default password is used, you will be prompted to change it upon first login.

Uninstall Neo4j

Follow these steps to uninstall Neo4j:

(Optional) Create a backup to avoid losing your data.
Uninstall Neo4j:
```
sudo yum remove neo4j
```