Installing neosemantics
To install Neosemantics you will need to download a prebuilt .jar
from the releases area on the Github repository.
Standalone Instance
Once you have obtained the .jar
file for your version of Neo4j, you should copy it into the plugins/
folder within the $NEO4J_HOME directory of your Neo4j instance.
If you have not installed any plugins, this folder will contain a README.txt
file.
$ ls plugins
README.txt neosemantics-4.0.0.1.jar
To enable the Export HTTP endpoint you will also need to include following line in your $NEO4J_HOME/conf/neo4j.conf
configuration file:
dbms.unmanaged_extension_classes=n10s.endpoint=/rdf
Once you have installed the plugin, you will need to restart the Neo4j instance before the plugin become available.
$ bin/neo4j restart
Starting Neo4j.
Started neo4j (pid XXXXX). It is available at http://localhost:7474/
There may be a short delay until the server is ready.
Causal Cluster
To install Neosemantics on to a Causal Cluster, you should follow the installation instructions above on each cluster member. The plugin will only be available on each individual instance once it has been restarted.
Neo4j Desktop
-
Click the three dot menu to the top left of the card of the database that you would like to install the plugin to
-
Click on the Manage icon
-
Click the downwards arrow next to the Open Folder button and click Plugins
-
Move the
.jar
file into the resulting window -
Click the Restart icon to restart the database, or click the Play button to start the database.
The Neosemantics Graph App will guide you through the process of installing the plugin.
Docker
Neosemantics can be installed on a Neo4j Docker instance by providing adding n10s
to the NEO4JLABS_PLUGINS
environment variable:
docker run \
--name testneo4j \
-p7474:7474 -p7687:7687 \
-d \
-v $HOME/neo4j/data:/data \
-v $HOME/neo4j/logs:/logs \
-v $HOME/neo4j/import:/var/lib/neo4j/import \
-v $HOME/neo4j/plugins:/plugins \
--env NEO4JLABS_PLUGINS='["apoc", "n10s"]' \
--env NEO4J_AUTH=neo4j/test \
neo4j:latest
Verifying the Installation
To verify that the plugin has been installed, you can run the following Cypher query to list the procedures registered on the Neo4j instance.
This query should return a number of procedures where the name begins with n10s
.
SHOW PROCEDURES yield name, description, signature
You can check that the HTTP endpoints have been mounted by running a GET request to the /rdf/ping
endpoint.
:GET http://localhost:7474/rdf/ping
The previous command assumes you’re running neo4j on your local machine, replace localhost
with the host name if that is not the case.
Glossary
- $NEO4J_HOME
-
The directory in which you have installed Neo4j. This will contain a
bin/
folder which holds theneo4j
executable, plus conf, data and plugins.For more information, see the Operations Manual
- APOC
-
APOC is a library of procedures and functions that make your life as a Neo4j user easier.
- Causal Cluster
-
A highly available cluster of Neo4j servers