Knowledge Base

Article ID: 227 - Last Modified:

How do I recover a project that has become corrupt?

First, you should make a backup copy of the project, in case the recovery method you choose does not succeed. On Linux, run the following command:

cp -r project.prj project_backup.prj

On Windows, you can control-drag the folder to another location, or copy and paste the project folder into the current location, where it is saved with a new name.

There are several ways in which you can try to recover the project, depending on what state it was in when it was corrupted, and what backup information you have. Maestro offers to try three of these when it cannot open a project: restore from a backup, restore from an initial state, or recover what information is recoverable. You can use any of these options in Maestro. If you want to try other options, use one of the recovery methods listed below. If an attempt to recover the project fails, you should replace the project with your backup copy before trying another method (remove it first, then copy the backup).

  • Delete the .mmproj-cleanup folder from inside the project, and then try opening the project in Maestro. This method should restore the most recent data, if it succeeds.
  • Try recovering the project with the following command:

    project_extract -i project.prj -o new-project-name.prj -e all

    On Linux, prepend the command with $SCHRODINGER/utilities/; on Windows, open a Schrodinger Command Prompt window from the Start menu to execute the command. This method tries to recover the most recent data from the project.
  • If you made a backup of the project from Maestro, you can restore the project from this backup. Backups are kept in the folder project.backup, which is in the same folder as your project.
  • If you have the compressed initial state of the project present as a .mmproj-admin-os.tar.gz file, you could try re-creating the project_descriptors_file in the project folder and using the .mmproj-admin-os.tar.gz compressed copy to restore the project. The steps are as follows:

    1. Look in the project_descriptors_file in your project to determine the project entry format version.
    2. Delete the .mmproj-admin folder from your project.prj folder
    3. Create and save a text file named project_descriptors_file which should have the following single line:

      project_entry_format v2.2

      Replace the version with the current version if necessary. This should replace the previous version of the file.
    4. Check with the ls -al command that the only two files present in your project_copy.prj folder are:


    5. Launch Maestro and try opening project.prj

Finally, you should consider making a backup copy of your project when you have made significant changes.

Keywords: Maestro , project , corrupt , extract , recover

Back to Search Results

Was this information helpful?

What can we do to improve this information?

To ask a question or get help, please submit a support ticket or email us at
Knowledge Base Search

Type the words or phrases on which you would like to search, or click here to view a list of all
Knowledge Base articles