Logs for support
When something jams, the logs are the fastest route to the cause: YouniqMail continuously writes events, warnings and errors to files that record exactly what went wrong and when. A support request with logs almost always skips the “could you describe that in more detail?” round.
Opening the log folder
Section titled “Opening the log folder”The comfortable way goes through the app: under Settings → Advanced, in the Logging section, Log files location: shows the path as a link. Clicking it opens the folder.
If the app will not even start, reach the folder directly in the file
system: it sits in the data directory under logs:
~/Library/Application Support/YouniqMail/logs/In Finder: Go → Go to Folder… and paste the path.
%APPDATA%\YouniqMail\logs\Paste the line into the Explorer address bar as is, Windows resolves
%APPDATA% itself.
~/.config/YouniqMail/logs/The current file is main.log. When it reaches 5 MB, it becomes
main.old.log and a new one starts; older states are overwritten in
the process.
Debug logging
Section titled “Debug logging”For stubborn cases there is the verbose level: the Enable debug logging switch under Settings → Advanced. The app then records in much more detail, including the duration of many operations, and becomes somewhat slower. The sensible sequence:
- Enable debug logging.
- Trigger the problem once, deliberately.
- Collect the logs, switch debug back off.
What the logs contain, and what not
Section titled “What the logs contain, and what not”Logs contain technical events: timestamps, error messages, affected account IDs and server names. YouniqMail filters out passwords, access tokens and keys before writing, and folder names are shortened in many places. Mail texts and subject lines are not in them, but email addresses can appear. Take a quick look before sharing if that matters to you; the files are plain text.
To support
Section titled “To support”Send the main.log (with a freshly reproduced problem it suffices,
otherwise main.old.log too) together with three details:
- What did you do? (“fetched account X”, “opened a mail with a large attachment”)
- What happened, and what did you expect?
- Since when? (“after the update”, “since switching providers”)
A diagnostic report helps too: under Settings → Import / Export, in the Report a problem section, Export diagnostic report creates a file with the app version, operating system, database statistics (counts only) and the anonymized structure of your rules. Mail contents, contacts and passwords are not included.
With that, the search is a short one in most cases.