Skip to main content
Back to homepage →

How to create and use a Rescue Library. - Knowledgebase / Paperless for Mac OS / General Troubleshooting - Mariner Software

How to create and use a Rescue Library.

Authors list

If a Paperless library is determined to be corrupted, one way to attempt to recreate it is to create a rescue library. A Rescue Library is a library you can create in Finder, with files from your Paperless library file that allows you to

Follow these steps to create a rescue library:

1. Make sure Paperless is quit.

Make sure that Paperless is not currently running.

2. Locate your Paperless library file in Finder.

In Finder, locate your Paperless library file. Generally, this is the folder you saved the library in when you first created it.

For more information on how to locate your Paperless library file (including the default locations a library file might be stored in), please see this knowledge base article.

3. Navigate to the top level of your Paperless library file.

For more information on navigating within your Paperless library file in Finder, please refer to this knowledge base article.

4. In Finder, create a folder named Rescue Library.

Create a new folder in Finder and name it Rescue Library.

Generally your Documents folder (or the folder you normally store your Paperless library in) is the best place to create a Rescue Libray folder.

5. Copy the appropriate files (from within your lirbary file) to the Rescue Library folder.

Typically, you should only need to copy two files from your existing library:

  • The Documents folder
  • DocumentWallet.documentwalletsql, the database file for your Paperless library

We may instruct you to copy other files, as well; unless we do, only copy these files.

Be sure to copy these files to the Rescue Library folder; do not simply move them. One way you can copy files in Finder is to hold the option key down while you are dragging (or before you begin dragging) your Paperless library file.

6. Rename the Rescue Library folder (add the appropriate file extension).

Add the appropriate file extension to the Rescue Library folder. Depending on the version of Paperless you are

  • If you are using Paperless 2, the name of your library file will end in .paperless.
  • If you are using Paperless 1, the name of your library file will end in one of two different extensions, depending on the type of library it is:
    • Paperless document library files end in the extension .dwlibrary.
    • Paperless receipt library files end in the extension .rwlibrary.

If you are uncertain which version of Paperless you are using, you can determine this information by launching Paperless and selecting About Paperless from the Paperless menu. If you launch Paperless while creating a Rescue Library, be sure to quit Paperless before attempting to work with library files (or the Rescue Library folder) again in Finder.

Once you have added an extension to the Rescue Library folder, the folder's icon in Finder should change: it should now display the icon for a Paperless library file.

7. Open the rescue library in Paperless.

In Finder, double-click the Rescue Library. This should launch your Rescue Library in Paperless.

What can I do with a Rescue Library?

A Note about Rescue Libraries created from Encrypted Libraries

If you create a rescue library from an encrypted Paperless library, the rescue library will not be encrypted.

To encrypt a Rescue Library, select Encrypt Library from the File menu.

Helpful Unhelpful

10 of 16 people found this page helpful