Visual tour

This section gives an overview of the various features of Desktop, including the different set of drawers and bars.

visual tour 3

Projects

A Project in Desktop is a representation of a development folder on disk. You can create local database management systems (DBMSs), connect to remote DBMSs and add files within your project. Neo4j Desktop allows you to manage multiple Projects and it is easy to move both DBMSs and files between different Projects by drag and drop. However, you can have only one active DBMS or remote connection at a time.

Each DBMS in a Project contains a list of its databases, which is expanded when a DBMS is selected. If the DBMS is stopped, the list of databases is cached. The list is then updated again when you start the DBMS. However, for new DBMSs, the list of databases is not available until the DBMS has been successfully started for the first time.

new menu

Use the New menu to create a project locally or from a directory. You can also import projects from archive and import sample projects from the official Neo4j Graph Example repository on GitHub.

DBMS

A DBMS, database management system, is a Neo4j server instance which contains a minimum of the system database and a default database. Upon creation of a DBMS, the default database is called neo4j, but you can rename it or create a new database as the default. Existing DBMSs can also be accessed through the DBMS menu.

Neo4j Desktop includes a free Developers License of Neo4j Enterprise Edition which gives the user local access to Enterprise Edition features, such as multiple databases. A DBMS in Desktop can thus contain a number of databases in addition to the system and default databases. Please see the Operations Manual → Database administration for more information on multiple databases.

When you create a new DBMS in a Project, this will be with the default version of Neo4j. However, you are able to select a different version of Neo4j. Keep in mind that this often requires the resources for this to be downloaded and thus requires an internet connection.

A plugin is additional functionality that can be enabled for a DBMS. With the latest version of Neo4j Desktop, the following plugins are available for installation for your local DBMS:

  • APOC - A library of user-defined procedures and functions to help with many different tasks in areas like data integration, graph algorithms or data conversion.

  • GDS Library - Common graph algorithms for Neo4j.

  • GraphQL - A GraphQL-endpoint extension that translates GraphQL queries into Cypher statements.

  • Neo4j Streams - An integration between Neo4j and Kafka in order to ingest data into your graph or to send update events to the event log.

  • neosemantics (n10s) - A plugin that enables the use of RDF and associated vocabularies in Neo4j.

Neo4j Desktop lets you view and modify the settings for your DBMS directly. By selecting Settings from the More Options-menu, an editable neo4j.conf opens in a new window. However, for most settings, a modification requires the DBMS to be restarted for the change to take effect. Please see Operations Manual → The neo4j.conf file for more information on the contents of the neo4j.conf.

Similarly, the log files; debug.log, neo4j.log, query.log and security.log can also be viewed directly from Desktop, from the Logs in the More Options-menu. This opens a separate window displaying selected log-file. You can also access the logs from Open folderLogs.

logs

Memory configuration

Desktop sets the following memory configuration for each created DBMS, by default:

dbms.memory.heap.initial_size=512m
dbms.memory.heap.max_size=1G
dbms.memory.pagecache.size=512m

If you need a different memory configuration for your setup, you can edit the neo4j.conf file of each DBMS to suit your needs. As mentioned above, the neo4j.conf file can be accessed from the Settings option in the More Options-menu.

Keep in mind that the DBMS should be restarted after any changes to the neo4j.conf file for the changes to take effect.

For more information on memory configuration, please see Operations Manual → Memory configuration.

Remote connection

Apart from managing local DBMSs, Neo4j Desktop also allows you to connect to a remote instance. This can be an instance running on GCE, Aura, or hosted on a local network, for example. The remote connection uses the bolt protocol.

remote connection

Remote connections are accessible for each Project, in the Add-dropdown menu. See Connect to a remote DBMS to learn more about how to connect to a remote instance.

Graph Apps

There are several ways to interact with the graph. One way is using graph applications and Desktop comes bundled with a list of such applications. Two of them are formal Neo4j products, Neo4j Browser and Neo4j Bloom, and the others are applications with limited support from Neo4j Labs. Neo4j Browser and Bloom are used to visualize and query the graph, but other applications offer import tools for relational databases, monitoring tools and query log analyzers, for example. For more information about Browser and Bloom, see Browser documentation and the Bloom documentation.

The graph apps can be found in a curated list in the Graph Apps Gallery in Desktop.

graph apps drawer

As of Desktop v1.6, it is not possible to install third-party graph apps. However, the graph apps that are already installed will continue to work.

The graph applications can be launched from the sidebar, from the Open menu, or from the action bar.

Action bar

Represented as a magnifying glass, the Action bar offers quick access to graphs, apps, and commands. Through it, you can:

  • Start graphs

  • Stop active graph

  • Show log file of Neo4j Desktop

  • Show log file of active graph

  • Access the manage view of any graph

  • Open Graph Apps

  • Show IP address view of any graph.

Files

Apart from adding DBMSs, Desktop also lets you add files and folders to your Project. These can be Cypher files and Neo4j Browser guides which will both open in Neo4j Browser when you click them. In addition, you can also add database dump files to this section. The dump files can be used to restore a DBMS and thus add it to your Project.

To add files, you can use the Add dropdown menu in your Project or you can drag and drop the files into the File section. If you place files in the Project folder, e.g. with your file manager or from the command line, Desktop picks them up and display them in this section. The dropdown menu lets you filter your added files and folders by name, size, date of creation, date of last modification, or date it was last opened.

files

You can move your files easily between Projects by dragging a file from this section and dropping it in a different Project in the Project menu on the sidebar.