How to Restore a Complete Roam Graph

Ramses Oudt
Ramses Oudt
How to Restore a Complete Roam Graph

Using an EDN backup file you can restore a complete Roam graph to its original state. Learn how to restore your data, and what to keep in mind when doing so.

This article describes how to import an entire Roam database (graph) using a .edn backup file. This procedure will wipe the entire graph you import the file in. It’s best used to restore an existing graph into a new (offline) graph.

What is an EDN backup file?

EDN (.edn extension) is an open file format used for data structure. It’s a file format that works with Clojure, the programming language that Roam was created with.

The sentence above is not so important, though. What matters is that EDN files can be read by open source programs, which makes it a safe way to backup your Roam graph.

The main difference with JSON backup files is that EDN backups overwrite your entire database, whereas JSON files only add to your database (not overwriting any data).

How to create an EDN backup file

EDN files can be easily created using the Export All function from the menu (...), either manually or automatically.

Click here to learn how to manually create an EDN file.

Click here to learn how to set up automated backups in Roam.

How to restore an entire graph using an EDN backup file

Warning! The procedure below will erase the entire graph you import the .edn file into.

Step 1: Open settings.
Open the Settings from the top-right menu (...):

Step 2: Navigate to restore graph option.
From the settings screen, go to the Graph tab.

Next, click the red button that says Restore this graph:

Step 3: Select backup to restore.
Click the Choose File button and select the .edn backup file you wish to restore.

Next, enter the name of your graph (case sensitive). This is an extra security layer to ensure you don’t accidentally overwrite your graph.

Finally, click the button that says I understand the consequences, restore this graph to the backup:

Step 4: Start the restore.
After confirming you want to restore the graph, you’ll see the progress screen.

Click the blue Start button to initiate the restore process:

Step 5: Exit to the restored graph.
Once Roam finishes restoring the EDN file, the green Exit button becomes clickable. Click it to be taken to your freshly restored graph:

Join the conversation.

Great! Check your inbox and click the link
Great! Next, complete checkout for full access to Think Stack Club
Welcome back! You've successfully signed in
You've successfully subscribed to Think Stack Club
Success! Click here to start your premium onboarding.
Success! Your billing info has been updated
Your billing was not updated