# Install Neo4j plugin

## Install the Neo4j plugin

Install the Neo4j plugin following [these instructions](https://icij.gitbook.io/datashare/local-mode/plugins-and-extensions).

## Configure the Neo4j plugin

1\. At the bottom of the menu, click on the '**Settings**' icon:

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-81194835a51c3abf22fff43443546f4bc47c15fe%2FScreenshot%202025-06-11%20at%2011.05.58.png?alt=media" alt="Screenshot of Datashare&#x27;s homepage with the Settings icon at the bottom of the menu highlighted"><figcaption></figcaption></figure>

2\. Make sure the following settings are properly set:

* `Neo4j Host` should be `localhost` or the address where your Neo4j instance is running
* `Neo4j Port` should be the port where your Neo4j instance is running (`7687` by default)
* `Neo4j User` should be set to your Neo4j user name (`neo4j` by default)
* `Neo4j Password` **should only be set if your Neo4j user is using password authentication**

3\. **When running `Neo4j Community Edition`, set the `Neo4j Single Project` value**. In community edition, the Neo4j DBMS is restricted to a single database. Since Datashare supports multiple projects, you must set the `Neo4j Single Project` with the name of the project which will use Neo4j plugin. **Other projects won't be able to use the Neo4j plugin**.

4\. Restart Datashare to apply the changes. Check how for [Mac](https://icij.gitbook.io/datashare/local-mode/install-datashare-on-mac/open-datashare-on-mac), [Windows](https://icij.gitbook.io/datashare/local-mode/install-datashare-on-windows/open-datashare-on-windows) or [Linux](https://icij.gitbook.io/datashare/local-mode/install-datashare-on-linux/open-datashare-on-linux).

5\. Go to '**Projects**' > **your project's page** > the **Graph** tab. You should see the Neo4j widget. After a little while, its status should be `RUNNING`:

<figure><img src="https://2881303961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWCyd3pDXO_H4jk9DgG%2Fuploads%2Fgit-blob-429c93c99975633c63d400683cc2ad06724dd720%2FScreenshot%202025-06-11%20at%2011.10.00.png?alt=media" alt="Screenshot of a Project&#x27;s page on the Graph tab with the Running status highlighted"><figcaption></figcaption></figure>

You can now [create the graph](https://icij.gitbook.io/datashare/local-mode/create-the-neo4j-graph/create-and-update-the-graph).