Help · Support

A problem that is not listed here?

Then write to us through the contact form and send the app's debug log with it. For most problems we only find the cause with this log, and for transfers and syncing almost always. This page says what belongs in the form and how to create the debug log.

Check first

If a document is missing or a device does not keep up, the guide When something is wrong often helps already: it shows how to repair the library and how to see in the sync journal what your devices are about to do. For a storage location that will not connect there are guides for NAS (SMB) and Nextcloud and WebDAV.

The contact form

  1. Open the form

    The easiest way is from the app: on the iPhone, the library's title menu has “Help” under “More”; on the iPad, “Help” is in the sidebar; on the Mac, open the “Help” menu in the menu bar. Choose “Report a bug” there (on the Mac “Report a Bug…”). Device and version are then filled in for you. Without the app, the form is at the bottom of the Support page.

  2. Choose “Support / problem”

    For this topic the form asks for the device, system version, PaperPeace version and storage location. Fill in what you know. The storage location alone often tells us where to look.

  3. Describe the problem

    Three sentences are usually enough: What did you do? What did you expect? What happened instead? If the app shows a message, copy its wording or attach a screenshot.

  4. Send the debug log with it

    How to create it is in the next section.

The debug log: essential for most problems

PaperPeace records what it does: every sync, every transfer, every import, as numbered lines. The log stays on your device until you export it yourself. Your description tells us what you saw. The log tells us what the app was doing at that moment and where it got stuck. For problems with transfers or with syncing between devices it is usually the only way to the cause.

What the debug log contains

The lines of the system logs name none of your documents or folders and no sign-in credentials. If you also turn on the debug log (step 2), it also contains file and folder names with their full path, the names of your storage locations and the address of your server, error messages from storage providers and mail servers, the type and tags of recognised documents and the descriptions of your own fields. The documents themselves, that is the files, are not in the archive. We read the log only to find your problem.

  1. Open “System logs”

    With a sidebar, for example on the iPad and the Mac: in the sidebar under “More” › “System logs”. Without a sidebar, for example on the iPhone: in the library's title menu under “More” › “System logs”.

  2. For transfers and syncing: turn on the debug log

    Choose the three dots at the top (“More actions”) and then “Debug log …”. Turn on “Record debug log” and close the window with ✕. Then make the problem happen again, for example by transferring the file once more or by waiting on the other device until it is missing. Only now does the log hold everything we need.

    For other problems you can skip this step.

  3. “Export logs …”

    Again through the three dots (“More actions”) › “Export logs …”. The app packs the logs into a ZIP archive with a name like “PaperPeace-Logs-2026-11-15-1430.zip”. On the iPhone and the iPad the share sheet opens; “Save to Files” stores the archive. On the Mac, choose a place in the save window, for example the desktop.

    Export soon after the problem: the app keeps only the last 2,000 lines, older ones drop out over time.

  4. Send the ZIP archive

    In the contact form, choose “Attach debug log” under the topic “Support / problem” and pick the archive or drag it onto the button. For problems between two devices, add both archives.

    If the archive is too large for the form, or you have already written to us, attach it to an e-mail to support@paperpeace.app or to your reply to our mail.

  5. Afterwards: turn the debug log off and delete it

    The debug log is meant for one measurement only. Open “More actions” › “Debug log …” again and turn off “Record debug log”. The app then asks “Delete debug log?”. If you have already sent the archive, choose “Delete”.

    If you still want to export it first, choose “Keep”. Later you delete it in the same window with the “Delete debug log” button at the top (trash icon). Turning it off alone deletes nothing: as long as the recording is there, every export includes it.

Two devices involved?

If a file is missing on one device but present on the other, send the debug log from both devices. One shows what was uploaded, the other what arrived.

What happens next

Your message reaches our support mailbox. We answer by e-mail to the address you gave in the form. If we need more, we ask.