# How to run Neo4j?

## Run Neo4j inside docker

1\. enrich the `services` section of the `docker-compose.yml` of the [install with Docker](https://icij.gitbook.io/datashare/local-mode/install-with-docker) page, with the following neo4j service:

{% code fullWidth="true" %}

```yaml
...
services:
    neo4j:
      image: neo4j:5-community
      environment:
        NEO4J_AUTH: none
        NEO4J_PLUGINS: '["apoc"]'
      ports:
        - 7474:7474
        - 7687:7687
      volumes:
        - neo4j_conf:/var/lib/neo4j/conf
        - neo4j_data:/var/lib/neo4j/data
```

{% endcode %}

make sure not to forget the [APOC plugin](https://neo4j.com/developer/neo4j-apoc/) (`NEO4J_PLUGINS: '["apoc"]'`).

2\. enrich the `volumes` section of the `docker-compose.yml` of the [install with Docker](https://icij.gitbook.io/datashare/local-mode/install-with-docker) page, with the following neo4j volumes:

{% code fullWidth="true" %}

```yaml
volumes:
  ...
  neo4j_data:
    driver: local
  neo4j_conf:
    driver: local
```

{% endcode %}

3\. Start the `neo4j` service using:

{% code fullWidth="true" %}

```bash
docker compose up -d neo4j
```

{% endcode %}

## Run Neo4j Desktop

1. install with [Neo4j Desktop](https://neo4j.com/docs/desktop-manual/current/), follow installation instructions found [here](https://neo4j.com/docs/desktop-manual/current/installation/)
2. [create a new local DBMS](https://neo4j.com/docs/desktop-manual/current/operations/create-dbms/) and save your password for later
3. if the installer notifies you of any ports modification, check the [DBMS settings](https://neo4j.com/docs/desktop-manual/current/visual-tour/#dbms) and save the `server.bolt.listen_address` for later
4. make sure to install the [APOC Plugin](https://neo4j.com/docs/desktop-manual/current/operations/install-plugin/)

## Additional options

Additional options to install neo4j are [listed here](https://neo4j.com/docs/operations-manual/current/installation/).