Custom Databases
Connect your Neo4j or Memgraph database to GraphPolaris.
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.