Q100039: Restoring a Mari project from a backup

Follow

SUMMARY

This article explains how to restore your Project from an automatically generated backup file called Project.mri.bak, available in your Project Location. However please be careful and always make sure to make a backup copy of the affected project before following each step precisely.

The most common reason to require a backup is Project corruption, which can have various causes. It's often caused by interactions over the network or changes to the folder structure of your project, such as those potentially inflicted by disk cleanup tools. The consequence is that the user is no longer able to open their Mari Project.

 

Project.mri.bak VS Automatic Backup & Restore

Please note that the backup restoration method described in this article is separate from the Automatic Backup & Restore system new to Mari 7.

The Project.mri.bak file used in this article is always automatically generated, but it's less predictable. In contrast, the new system provides loads of control and other advantages, but it must be turned on for each individual Project before it starts being generated.

For more information about the Automatic Backup & Restore system, please refer to the following articles:

 

 

MORE INFORMATION

Please follow these instructions carefully, as deviation can cause additional issues.

  1. Launch Mari.

  2. Hover your mouse over the affected project in the project tab until the tooltip pops up.

  3. Write down the first 4 digits of the UUID.

  4. Close Mari! If Mari is open during the next steps, irreversible project corruption can occur.

  5. Open a file browser and navigate to your Project Location. If you don't know your Project Location, you can check it in Mari by selectin Edit > Preferences > Data> Project > Project Location.

  6. You will see a number of folders each with long UUID hash names. These are your Projects, and they should look something like this:



  7. Select the folder that starts with the UUID of your affected Project (noted down in step 3) and copy it to a safe location on a different directory. This is so that you have a copy of the Project, as the next steps can cause irreversible changes.

  8. Now open the folder that starts with the UUID noted earlier (the one in the Project Location, not the copy done in Step 7).
    You should see something like this:
  9. Rename Project.mri to Project.OLD

  10. Rename Project.mri.bak to Project.mri

  11. Now start Mari again and attempt to open your Project.

 

 

FURTHER HELP

If you are still experiencing difficulties please create a Support ticket and provide us with the information requested in this article:
Q100090: Information to send to support when reporting a Mari issue

For more information on how to open a Support request, please refer to this article:
Q100064: How to raise a support ticket

    We're sorry to hear that

    Please tell us why