Chapter 2. Installation

You can either download a prebuilt jar from the releases area or build it from the source. If you prefer to build, check the note below.

  1. Copy the the jar(s) in the <NEO_HOME>/plugins directory of your Neo4j instance. (note: If you’re going to use the JSON-LD serialisation format for RDF, you’ll need to include also APOC)
  2. Add the following line to your <NEO_HOME>/conf/neo4j.conf (notice that it is possible to modify where the extension is mounted by using an alternative name to /rdf below).
dbms.unmanaged_extension_classes=n10s.endpoint=/rdf
  1. Restart the server.
  2. Check that the installation went well by running

    call dbms.procedures()

The list of procedures should include the ones documented below. You can check that the extension is mounted by running

:GET http://localhost:7474/rdf/n10s/ping

The previous command assumes you’re running neo4j on your local machine, replace localhos with the host name if that is not the case.

Note on build

When you run

  mvn clean package

it will produce two jars

  1. A neosemantics-[…​].jar This jar bundles all the dependencies.
  2. An original-neosemantics-[…​].jar This jar is just the neosemantics bit. So go this way if you want to keep the third party jars separate. In this case you will have to add all third party dependencies (look at the pom.xml).

2.1. Feedback

Please provide feedback and report bugs as GitHub issues or join the Neo4j Community forum.

2.2. Acknowledgements

Neosemantics uses rdf4j for parsing and serialising RDF. Eclipse rdf4j is a powerful Java framework for processing and handling RDF data.