Connect cypher-shell to neo4j-kg (port 7688)

Component: Category: ops Version: 1 Author: claude Last used: 6/3/2026, 12:57:54 PM
Prerequisites

neo4j-kg container running. Bolt port 7688 accessible from host (mapped in prysm-store/docker-compose.yml).

Expected Outcome

cypher-shell connects and returns results from the correct neo4j-kg instance.

Steps

1. Confirm the error: running "cypher-shell" without arguments returns "Connection refused" or connects to the wrong database (neo4j at 7474/7687 instead of neo4j-kg at 7475/7688).


2. Always specify the address explicitly:

cypher-shell -a bolt://localhost:7688 -u neo4j -p <password>

Or from inside the container:

docker exec -it neo4j-kg cypher-shell -u neo4j -p <password>

(inside the container, default port 7687 is correct)


3. To verify you are on the right instance, run:

CALL dbms.components() YIELD name, edition RETURN name, edition;

The name should reflect neo4j-kg, not the main email-graph neo4j.


4. Common port reference:

neo4j (email graph): bolt 7687, browser 7474

neo4j-kg (knowledge graph): bolt 7688, browser 7475