GrapheneDB database users

For higher security, GrapheneDB uses a custom authentication system to manage database connections. Much like Neo4j's built-in system, authentication is handled using a username/password combination.

With GrapheneDB, a Database User consists of a:

  • Label to identify it among others
  • Username, that is automatically generated based on the assigned label.
  • Password, also automatically generated and only visible once upon creation.

This system allows you to:



All database users have read and write permissions.

Creating a database user

After creating a new database, it will not accept any incoming connections. Create a database user and store its username and password to connect your application, Neo4j Browser or CLI.

Add new users using the Create user button in the Database users section in the Connection tab.


A new window will be displayed:


Enter a label to identify the user and optionally set an expiration time. If the Expiration field is set to “Doesn’t expire”, a permanent user will be created. You can read more on temporary users here.

After submitting the form using the Create user button, the user will be created and its username and password displayed.



The password is only visible once in this step, so it should be copied and safely stored at this time. If the password can no longer be retrieved or is lost, the user should be deleted and a new one created.


Upon confirmation, the window will be closed and the new user will be visible in the Database users section.


Although you won’t be able to see the password again, you will find some useful information here:

  • Created by: the GrapheneDB user that created the user, useful if you are using our team collaboration feature.
  • Created: The date the user was created
  • Last access: The last date the credentials were used to connect to the database
  • Expires: Expiration date in case of a temporary user

Retrieving username and password of a user

When creating a database user, its username and password are automatically generated. For better security, passwords are stored encrypted and only visible once upon creation. Use View to retrieve the username for a database user

Because password are stored encrypted, it is not possible to retrieve the password at a moment other than upon creating the user. If a password is lost the user should be deleted and a new one created.

Dropping a user

If credentials have been accidentally leaked, the user no longer necessary or someone with access to it left your team, it is a good idea to delete the database user.

You can do so by following the Drop next to the database user you want to remove in the Database users section in the Connection tab.



If the user is in use and you want to delete it, it is a good idea to create a new user first, update the credentials in your app and verify that the new connection is working correctly before proceeding.


Temporary database users

There are cases where a connection is only needed temporarily, for instance:

  • using the Neo4j Browser or CLI to run queries
  • running short-lived scripts for reporting, migrating data or schema

In such cases temporary database users can be used. They expire automatically after a certain time, without the need to manually drop the user.

You can create a new temporary user by selecting an expiration time in the Create new user form.


After creation, the temporary user will appear in the database user list with its expiration date and a special icon for easy recognition.

Temporary users are visible until they expire and can be optionally dropped before they have automatically expired.




When opening the Neo4j Browser on databases with version older than 3.2.1, a new temporary user will be created.

Accessing the Neo4j Browser

To access the Neo4j Browser, an existing database user is needed. You can create a temporary database user or drop it anytime from the User management section in the Connections tab.




Databases with version older than 3.2.1 don’t need to explicitly create a database user. A temporary user will be generated when the browser is launched.

Transitioning from legacy user to new database users

The new GrapheneDB database user authentication system will be rolled out in February 2017. All databases created after its release support only this new system. Please read more on how to manage database users here.

However, previously created databases will continue supporting legacy users indefinitely. Legacy users will be also displayed in the Database users section:




The legacy user will continue working, but for security reasons the password will not be displayed. If you have lost your password, please follow the steps below.

To improve the security of your database, we recommend that you to transition to the new database users system by following these steps:

  1. Create a new user
  2. Update your application to use the new username and password
  3. Verify that the application is connecting without issues using the new credentials
  4. Finally delete the Legacy user using the Drop link