Troubleshooting

Fixes for sync errors, credentials problems, and other issues.

• Mailspring won’t open, shows a blank window, or reports a database problemWhat to do when Mailspring starts to a white window, sits in the tray without a window, or loops on a local database error.
• Finding sync logs and error detailsWhere Mailspring keeps its sync logs and how to collect the details the community needs to help with a connection problem.
• I see winmail.dat attachments on my emails. How do I open them?Why Outlook sends winmail.dat files and how to open them on each platform.
• I'm getting a "Certificate Error" when connecting my accountFix SSL certificate errors caused by self-signed certificates or missing CA bundles.
• How do I make Mailspring the default mail client on Linux?Set Mailspring as the default handler for mailto: links from your system settings.
• Mailspring isn't showing the correct messages in my Sent or Drafts or Trash folder!Correct the folder Mailspring uses for Sent, Drafts, or Trash in Preferences > Folders.
• Your Mailspring ID is missing required fields.Fix keychain problems that prevent Mailspring from saving your Mailspring ID.
• Clearing the Mailspring cacheReset Mailspring completely by deleting its data folder.
• How do I update an N1 / Nylas Mail theme for Mailspring?Update a legacy Nylas Mail theme's package.json so it loads in Mailspring.
• I'm getting "Invalid Credentials" when connecting a Windows Live Domains accountWindows Live custom domains are deprecated; connect the underlying Outlook.com account instead.
• I'm getting "Invalid Credentials" when connecting an Outlook.com accountClear Microsoft's security challenge at account.live.com/activity and reconnect.
• I'm using iCloud two-factor authentication and can't sync my accountiCloud accounts with two-factor authentication need an app-specific password.
• "Password Management Error" on LinuxWhy Mailspring needs a working keyring on Linux, and fixes for GNOME, KDE, tiling window managers, snap, and Flatpak.
• Setting the spell check languageMailspring detects the language you write in; change your system language to change the default.
• Uninstalling MailspringQuit Mailspring, then remove the app and its data folder on macOS, Windows, or Linux.
• Matching the GTK theme on LinuxUse your desktop's own window controls and menu bar so Mailspring's title bar matches your GTK theme.
• My emails are going to recipients' spam foldersTracking pixels and links can trigger spam filters; disable tracking if it happens.