To import, export, or restore entire Neo4j databases from a backup, you must copy and replace the full Neo4j datastore — which is the graph.db directory containing the store files. Import and export can be managed from the Admin tab in the GrapheneDB UI.

## Supported Import formats

GrapheneDB expects a single compressed file containing the _graph.db_ directory and the store files located inside. Supported formats are: **zip, tar, cpio, gz, bz2 and xz**.

## Importing from your local Neo4j database into GrapheneDB

GrapheneDB supports uploading Neo4j store files to replace the store files in your GrapheneDB database. In order to import your local database into GrapheneDB, follow the steps below:

Step 1: **Important!** Make sure your local Neo4j instance is stopped. Step 2: Put the entire contents of graph.db in a compressed file.

Step 3: From the Admin tab, use the Restore button to initiate the import process. Step 4: Upload the compressed file from your local machine or provide a URL to a publicly accessible URL (i.e. a public link to a file hosted in an AWS S3 bucket).

## GrapheneDB export

There is a manual export feature that enables you to download a zipped file with your database. This feature is available across all plans, including Sandbox. This can be used together with the restore feature to clone your databases within GrapheneDB or to take your data elsewhere (i.e. your development machine).

You will this feature inside the _Admin_ tab of your database management area:


It is important to know that the database export process requires to stop the database meanwhile your data are copied. The incoming requests will be queued up during the process and served after the instance is up and running again.

You will be responsible of the exported data storage (we will not keep it!).

## GrapheneDB restore

You will find our restore database feature inside the _Admin_ tab of your database management area:


On _Restore database_ button click, a dialog will be displayed and you will be able to upload a file from your computer or provide a URL to a publicly accessible file on the internet.

If you want to upload a local database you must put the contents of the graph.db folder in a compressed file. For example:

Supported formats: zip, tar, cpio, gz, bz2 and xz

To restore datasets bigger than 5GB, please use _Load file from URL_. You will need to upload your file to a publicly accessible location and provide the URL. Please use a security mechanism to avoid compromising sensible datasets as pre-signed URLs.


The Neo4j instance will be stopped, the store files replaced, and then Neo4j will be started up again. If Neo4j fails to start properly, the database will be rolled back to its previous state before the restore attempt.

If you want to try out Neo4j and you are looking for example data there are some datasets on the [ website](🔗). You don't need to download the files, you can copy the download link URL and paste it in the restore dialog.

## Troubleshooting

When a restore process fails, it’s usually due to one of the following reasons:

  • The store files were copied while Neo4j is still running: Make sure Neo4j is stopped.

  • The store files correspond to a newer version of Neo4j than the one on GrapheneDB: Make sure you restore to the same version or higher.

  • The compressed file is not a supported format: Make sure you use one of our supported formats, which include zip, tar, cpio, gz, bz2 and xz.

  • There are store files missing within the compressed file: Make sure the archive contains the full _graph.db_ directory and all files inside (use the recursive option when creating the archive).

## Supported Archive Formats

The following archive formats are supported for archiving: zip, tar, cpio, gz, bz2 and xz.

## Loading an exported datastore into a local Neo4j instance

The exported GrapheneDB database can be loaded into a local Neo4j instance as follows:

Step 1. Export your GrapheneDB Neo4j instance from the _Admin_ tab, by using the Export button. Step 2. Copy the contents of the compressed zip file into _path/to/neo4j/data/graph.db_ in a local instance of Neo4j. Step 3. Restart the Neo4j server.

If you are using the desktop Neo4j application, the steps will vary as follows:

Step 1. Export your GrapheneDB Neo4j instance from the _Admin_ tab, by using the _Export_ button Step 2. Select the location of the compressed zip file by clicking on the _Choose_ button. Step 3. Click on _Start_ to start up your server again.