Connecting to your database
There are several different ways of connecting to the database that you can choose from.
Database Users are managed by the database. If your database is newly provisioned, please use the default user (neo4j/neo4j) to connect to your database for the first time. Please take a look at our article on managing users.
Finding your database connection details
To locate your database connection details, please navigate to your database management interface > Connect tab.
Connect using Bolt connection URI
Bolt is a binary protocol for Neo4j, which is designed for high-performance throughputs, using a compact binary encoding over persistent TCP connections. You can find more information on Bolt in the official release notes.
You can connect using Bolt with the Connection URI and the username and password of one of the database users that you can create via a Cypher command for example, using Neo4j Browser. Navigate to the Connect tab > Connection URI and from there, you can copy the URI.
Connect using Neo4j Browser
Neo4j databases come with a built-in, interactive UI that allows you to explore your database. Neo4j Browser is a developer-focused tool that allows you to execute Cypher queries and visualize the results. Simply navigate to the Connect tab > and either launch the Neo4j Browser or copy the URL of the Neo4j Browser.
If your database is newly provisioned, you will need to create a new database user to connect to your database. Please take a look at our article on managing users.
Connect from Neo4j Desktop
The first thing you’ll need is to have your GrapheneDB database created. Once the database is ready, the next thing you need is to create a database user. More info on managing users can be found here.
Now, please proceed to download and install the Neo4j Desktop , if you haven’t done so already.
-
Open Neo4j Desktop > Create Project > Give the project a name > click on +Add > choose Remote connection option.
-
Enter the Database Name and Connection (Bolt) URI. Click on the Next button. You can find your Connection URI in your Connect tab of the database management interface.
-
Now, to connect your database user, please select username/password option, enter the credentials, and click on Save button.
-
Finally, just click on Connect button and you should see the status changed to Active.
Connect using HTTP transactional API
You can also access Neo4j through the HTTP API. Please note that the official drivers do not support HTTP communication. The official documentation on the HTTP API can be found here.
To connect to the HTTP API directly or using a driver, please use the HTTPs URI, which you can find on the Connect tab of your database management interface, and please note that the default user (neo4j) needs to be changed. More info is in the following article on database users.
Troubleshooting connection issues
If you are experiencing connection problems, there are several potential causes to consider:
BOLT Connection URI
Ensure that required IP address is included in the IP whitelist rule within the Network Access section of your Environment. If the required IP is not whitelisted, or if access for all IPs is not enabled by adding 0.0.0.0/0 to the whitelist entry, the BOLT connection will fail. If you are using VPC peering, verify that VPC peering is correctly established and configured, because misconfigured VPC peering can prevent successful connections. More information about IP Whitelisting can be found here, and VPC peering as well.
Additionally, ensure that the BOLT connection URI is correctly formatted, because mistakes in the URI, such as incorrect hostname or port number, will result in connection failures. You can verify the BOLT connection URI in Connect tab of your database > BOLT Connection section.
Neo4j Browser access
Ensure that your IP address is included in the IP whitelist rule in the Network Access section of your Environment. If your IP is not whitelisted or if access for all IPs is not enabled by adding 0.0.0.0/0 to the whitelist entry, the Neo4j Browser will time out when attempting to open it. More information about IP Whitelisting can be found here.
Connecting from Neo4j Desktop
Verify that required IP address is added to the IP whitelist rule or add access for all IPs by adding 0.0.0.0/0 to the whitelist entry in the Network Access tab of your Environment. Alternatively, if you are using VPC peering, ensure that VPC peering is established and configured correctly. More information about IP Whitelisting can be found here, and VPC peering as well.
HTTP connection
Confirm that required IP address is added to the IP whitelist rule or add access for all IPs by adding 0.0.0.0/0 to the whitelist entry in the Network Access tab of your Environment. If you are using VPC peering, ensure that VPC peering is established and properly set up. More information about IP Whitelisting can be found here, and VPC peering as well.
Additionally, verify that connection string you are using is correct. You can find the HTTP Transactional API connection URL in Connect tab if your database > HTTP Connection section.
Wrong user credentials
Finally, the cause of connection problem could also be the wrong credentials, so please verify that you are using correct credentials. If the password can no longer be retrieved or is lost, the authentication of the database can be disabled like this, and then you can change users password, create new user, or whatever you decide is the best course of action.
Following these steps should help resolve any connection problems you may encounter.