Install Memgraph on Ubuntu

Install and run Memgraph on:

  • Ubuntu 18.04
  • Ubuntu 20.04
  • Ubuntu 22.04
⚠️

Newer versions of Memgraph might not be backward compatible with older versions and you might not be able to load storage snapshots between different versions. In that case, please contact the Memgraph team and we'll help with the migration as much as possible.

Installation guide

Download Memgraph Ubuntu Package

Downloaded the latest Memgraph Ubuntu Package from the Memgraph Download Hub (opens in a new tab).

You can also use direct download links to get the latest Memgraph packages.

For example, the following command will download Memgraph v2.14.1:

sudo wget https://download.memgraph.com/memgraph/v2.14.1/ubuntu-22.04/memgraph_2.14.1-1_amd64.deb
💡

For the latest version of Memgraph, replace the version in the download command with the one from the direct download links page.

Install Memgraph

After downloading Memgraph as an Ubuntu package, install it by running the following:

sudo dpkg -i /path-to/memgraph_<version>.deb

Why use sudo?

In order to perform some actions on your operating system like installing new software, you may need superuser privileges (commonly called root).

Troubleshooting

Unable to install the Memgraph package with dpkg

While running the following dpkg command:

dpkg -i /path-to/memgraph_<version>.deb

you may encounter errors that resemble the following:

dpkg: error processing package memgraph (--install): dependency problems -
leaving unconfigured Errors were encountered while processing: memgraph

These errors indicate that you don’t have all of the necessary dependencies installed. To install the missing dependencies and finish the installation, issue the following command:

sudo apt-get install -f

Verify that Memgraph is running

To verify that Memgraph is running, run the following:

sudo journalctl --unit memgraph

If successful, you should receive an output similar to the following:

You are running Memgraph vX.X.X

If the Memgraph database instance is not running, you can start it explicitly:

sudo systemctl start memgraph

Troubleshooting

When you start a Memgraph instance, you may see the following list of notes in your terminal:

You are running Memgraph v1.4.0-community
 
NOTE: Please install networkx to be able to use graph_analyzer module. Using Python:
3.8.2 (default, Jul 16 2020, 14:00:26)
[GCC 9.3.0]
 
NOTE: Please install networkx to be able to use Memgraph NetworkX wrappers. Using Python:
3.8.2 (default, Jul 16 2020, 14:00:26)
[GCC 9.3.0]
 
NOTE: Please install networkx, numpy, scipy to be able to use proxied NetworkX algorithms. E.g., CALL nxalg.pagerank(...).
Using Python:
3.8.2 (default, Jul 16 2020, 14:00:26)
[GCC 9.3.0]
 
NOTE: Please install networkx to be able to use wcc module.
Using Python:
3.8.2 (default, Jul 16 2020, 14:00:26)
[GCC 9.3.0]

If you wish to work with built-in NetworkX modules in Memgraph, you need to install the following Python libraries:

For more information on how to install Python libraries in Linux, follow the Installing Packages guide (opens in a new tab). If you are not interested in working with query modules that depend on these libraries, you can ignore the warnings.

If you run into any troubles while installing Memgraph, contact us on Discord (opens in a new tab).

Connect to the database

To query the database from the console, you need to install mgconsole.

You can also connect to the database using one of the client libraries or visual-user interface Memgraph Lab.

Stop Memgraph

To shut down the Memgraph server, issue the following command:

sudo systemctl stop memgraph

Start Memgraph

To start the Memgraph server, issue the following command:

sudo systemctl start memgraph

Configuration

If you're experiencing issues related to the maximum number of memory map areas, you can resolve them by adjusting the vm.max_map_count parameter.

The Memgraph configuration is available in /etc/memgraph/memgraph.conf. If the configuration file is altered, Memgraph needs to be restarted. Check all the configuration options in the Configuration section.