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.