Java is one of the Neo4j supported languages and an official driver is provided. Official drivers connect to the databases using BOLT protocol (HTTP/HTTPS is not available).


About connection parameters

We've used test credentials for all the following examples. Please replace them with your real connection parameters.

You'll find all the required information to connect to your database on our admin panel if you navigate to the Connection section. More on connecting to your database here

This section is intended to provide a small working example to connect to a GrapheneDB database using the Java driver. To get more detailed information, visit the driver web page:

The following example is a Maven application that just uses the driver to write and read a node.

Include Neo4j Java Driver in your dependencies in pom.xml file:



Check the driver releases for newest driver version available.


In the last version of Neo4j drivers the default configuration for encrypted option is now false. Since GrapheneDB only accepts encrypted connections, please ensure encryption is active.

Connect to the to a GrapheneDB instance using the connection settings and run a simple query of the Movies dataset example:

import org.neo4j.driver.*;

public class App 
  public static void main( String[] args )
    Config.ConfigBuilder builder = Config.builder().withEncryption();
    Config config =;

    Driver driver = GraphDatabase.driver("bolt://", AuthTokens.basic( "admin", "b.P0shGn2gvpUD.9RAHyuY4QXkkUK7w" ), config);

    Session session = driver.session();

    Result result ="MATCH (:Person {name: 'Tom Hanks'})-[:ACTED_IN]->(movies) RETURN movies.title AS title");

    while ( result.hasNext() )
      Record record =;
      System.out.println( record.get("title").asString() );


You can also use the new bolt+s URI scheme to enable encryption with a full certificate check:

Driver driver = GraphDatabase.driver("bolt://", AuthTokens.basic( "admin", "b.P0shGn2gvpUD.9RAHyuY4QXkkUK7w" ));

Updated about a month ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.