GraphPolaris connects to your existing graph database using standard protocols. Your data stays in your database—GraphPolaris only sends queries and receives results.
Supported Databases
| Database | Protocols | Default Port |
|---|---|---|
| Neo4j | neo4j://, neo4j+s://, bolt://, bolt+s:// | 7687 |
| Memgraph | bolt:// | 7687 |
The +s variants use TLS encryption for secure connections.
Connection Form
When adding a custom database, you'll provide:
| Field | Description | Example |
|---|---|---|
| Connection name | Display name in GraphPolaris | "Production Neo4j" |
| Database name | Internal database name | "neo4j" (default) or your DB name |
| Database type | Neo4j or Memgraph | — |
| Protocol | Connection protocol | neo4j+s:// for Aura |
| Host | Server hostname or IP | abc123.databases.neo4j.io |
| Port | Connection port | 7687 |
| Username | Database user | neo4j |
| Password | Database password | — |
Connecting to Neo4j
Neo4j Aura (Cloud)
- Log into Neo4j Aura
- Find your database connection URI (looks like
neo4j+s://abc123.databases.neo4j.io) - In GraphPolaris:
- Protocol:
neo4j+s:// - Host:
abc123.databases.neo4j.io(from your URI) - Port:
7687 - Username/Password: Your Aura credentials
- Protocol:
Neo4j Desktop
- Start your database in Neo4j Desktop
- Click Open → Neo4j Browser to verify it's running
- In GraphPolaris:
- Protocol:
bolt://orneo4j:// - Host:
localhost - Port:
7687 - Username:
neo4j - Password: The password you set during creation
- Protocol:
Self-Hosted Neo4j
- Ensure your Neo4j instance is accessible from where you're running GraphPolaris
- Check your
neo4j.conffor the bolt connector port - In GraphPolaris:
- Protocol:
bolt://(orbolt+s://if TLS configured) - Host: Your server hostname or IP
- Port: Usually
7687 - Username/Password: Your database credentials
- Protocol:
Security tip: Use
neo4j+s:// or bolt+s:// protocols when connecting over the internet to encrypt traffic.Connecting to Memgraph
Memgraph uses the Bolt protocol, same as Neo4j.
Memgraph Cloud
- Get your connection details from Memgraph Cloud
- In GraphPolaris:
- Protocol:
bolt:// - Host: Your Memgraph Cloud hostname
- Port:
7687 - Username/Password: Your credentials
- Protocol:
Local Memgraph
- Start Memgraph (via Docker or direct install)
- In GraphPolaris:
- Protocol:
bolt:// - Host:
localhost - Port:
7687 - Username/Password: Default is often empty or
memgraph/memgraph
- Protocol:
Troubleshooting
Connection Failed
- Check the host is reachable — Can you ping it? Is there a firewall?
- Verify the port — Is the database listening on the expected port?
- Try different protocols — Some setups work better with
bolt://vsneo4j:// - Check credentials — Username and password are case-sensitive
Connection Succeeds but Schema is Empty
- Database might be empty — Check if data exists in Neo4j Browser
- Permissions — Your user might not have read access to all labels
- Database name — Ensure you specified the correct database (not
system)
Timeout Errors
- Network latency — Cloud databases may need longer timeouts
- Large schema — Databases with many labels/types take longer to scan
- Database load — Heavy queries running might slow schema extraction
Next Steps
Once connected, GraphPolaris extracts your schema automatically. Learn more in the Adding Your Data overview.