All settings are configured on the Settings page. You don't need to edit any files directly. The sections below describe what each part of the Settings page controls.

Application

Controls top-level behavior. Use Dry Run to simulate a full run without moving files, sending emails, or writing any data — useful for testing after changes.

Schedule

When the daily pipeline runs automatically. Change the time and timezone here — PostMule will update your Windows Task Scheduler entry when you save.

Alerts

Where PostMule sends the daily summary and urgent notifications — for example, when a physical item needs forwarding or a bill is due soon. You can add a second recipient (a spouse, accountant, etc.) to be copied on all alerts.

AI / Classification

The AI service PostMule uses to read and classify your mail. The default (Gemini) is free. The confidence threshold controls how certain the AI needs to be before it files something automatically — items below the threshold go to Needs Review instead.

API Safety Limits

Hard limits on how many AI requests PostMule can make per day. These exist to protect you from unexpected charges. The defaults match Gemini's free tier. PostMule warns at 80% and stops if a limit is reached.

Bill Matching

How PostMule matches bills to bank transactions. By default, you approve each match before it's applied. You can also allow a small tolerance (in cents) if your bank rounds amounts slightly.

Data Protection

Safety guardrails. PostMule never permanently deletes files — deleted items go to Trash for manual review. A cap limits how many files can be moved in a single run to prevent runaway behavior.

Backups & Deployment

Daily encrypted backups are uploaded to your Drive automatically. You can trigger a manual backup any time. Deployment settings control the dashboard port and optional Tailscale remote access.

PostMule hasn't run today

• Check the Last Run status at the top of the Mail page
• Check that your computer was on at the scheduled time
• Click Run Now on the Settings page to trigger a manual run
• Check the Logs page for any error messages

I'm not receiving my daily summary email

• Check your spam or junk folder
• Verify the alert email address in Settings → Alerts
• Check the Logs page for email send errors

An item is in "Needs Review"

• PostMule wasn't confident enough to classify this item automatically
• Open the item on the Mail page, review the PDF, and assign a category manually
• If a particular sender ends up here often, add them to the Entities list

A bill shows as unpaid but I've already paid it

• PostMule may not have synced the matching bank transaction yet — check Providers to confirm your finance connection is active
• If bill matching is on, check the Pending tab for a match waiting for your approval
• You can manually mark a bill as paid from the Bills tab

PostMule stopped working after a Windows update

• Open the Logs page and look for the most recent error
• Try clicking Run Now — if it works, the scheduled task may need to be re-registered
• Go to Settings → Deployment → Re-register Scheduled Task

Something else is wrong

• Check the Logs page for recent errors
• Report the issue on GitHub