Airpost
Help

Troubleshooting

Fixes for sign-in problems, missing mail, sync errors, scheduled mail that didn't send, and plugins that break the app.

Most problems fall into one of three places: the connection to your provider, the engine on your computer, or something running in the app such as a plugin. The engine’s log usually tells you which. Start with the checks below, then find your symptom.

First checks

Is the engine running?

airpost status

This lists the running engines and the state of each account. If it exits with code 3, no engine is running: open Airpost, or start the background engine with airpost engine start.

What does the log say?

airpost logs me@example.com -n 50
airpost logs engine -f

Or Developer > Open Engine Logs, which opens the profile folder; each account’s log is engine-<accountId>.log.

Does it work without plugins?

Start Airpost with --safe (on macOS, open -a Airpost --args --safe). If the problem goes away, a plugin or theme you installed is the cause.

Signing in

Syncing

Scheduled mail, snooze and rules

Reading and composing

Plugins and services

Starting over

If nothing else works, you can rebuild one account, rebuild everything, or reset Airpost entirely. None of these touch mail on your provider. See Data and files.

Still stuck

Report it with Help > Report an Issue, or on GitHub. Include your OS, how you installed Airpost, and the relevant lines of the account’s log. Logs can contain folder names, addresses and server names, so look before you paste.

Report security problems privately through GitHub, not in a public issue. See Security.