macOS installation

Before you install Neo4j on macOS, check System Requirements to see if your setup is suitable.

Unix console application

  1. If it is not already installed, get OpenJDK 17 or Oracle Java 17.

  2. Download the latest release from Neo4j Download Center.

    Select the appropriate tar.gz distribution for your platform.

  3. Make sure to download Neo4j from Neo4j Download Center and always check that the SHA hash of the downloaded file is correct:

    1. To find the correct SHA hash, go to Neo4j Download Center and click on SHA-256 which will be located below your downloaded file.

    2. Using the appropriate commands for your platform, display the SHA-256 hash for the file that you downloaded.

    3. Ensure that the two are identical.

  4. Extract the contents of the archive, using tar -xf <filename>. For example, tar -xf neo4j-community-5.5.0-unix.tar.gz.

  5. Place the extracted files in a permanent home on your server. The top level directory is referred to as NEO4J_HOME.

  6. From Neo4j v5.4 onwards, you are required to accept the license agreement before running the Neo4j Enterprise Edition. If you are using Community Edition, you can skip this step.

    1. Use one of the following options to accept the commercial license agreement. See for more information.

      • Set the environment variable NEO4J_ACCEPT_LICENSE_AGREEMENT=yes.

      • Run <NEO4J_HOME>/bin/neo4j-admin server license --accept-commercial

    2. Use one of the following options to accept the evaluation license agreement. See for more information.

      • Set the environment variable NEO4J_ACCEPT_LICENSE_AGREEMENT=eval.

      • Run <NEO4J_HOME>/bin/neo4j-admin server license --accept-evaluation.

    3. To run Neo4j as a console application, use: <NEO4J_HOME>/bin/neo4j console.

    4. To run Neo4j in a background process, use: <NEO4J_HOME>/bin/neo4j start.

  7. Visit http://localhost:7474 in your web browser.

  8. Connect using the username 'neo4j' with default password 'neo4j'. You’ll then be prompted to change the password.

  9. Stop the server by typing Ctrl-C in the console.

When Neo4j runs in console mode, logs are printed to the terminal.

macOS service

Use the standard macOS system tools to create a service based on the neo4j command.

macOS file descriptor limits

The limit of open file descriptors may have to be increased if a database has many indexes or if there are many connections to the database. The currently configured open file descriptor limitation on your macOS system can be inspected with the launchctl limit maxfiles command. The method for changing the limit may differ depending on the version of macOS. Consult the documentation for your operating system in order to find out the appropriate command.

If you raise the limit above 10240, then you must also add the following setting to your neo4j.conf file:


Without this setting, the file descriptor limit for the JVM will not be increased beyond 10240. Note, however, that this only applies to macOS. On all other operating systems, you should always leave the MaxFDLimit JVM setting enabled.