Skip to content

[FEATURE] Add notifications for failed download/sync jobs #311

Description

@MikaelKW

Description

I would like to see built-in notifications/alerts for failed download/sync jobs.

For example, Bichon could notify the admin when an IMAP download job fails due to authentication problems, expired/revoked app passwords, OAuth/token issues, provider throttling/rate limits, connection errors, or other sync failures.

Possible notification methods could include one or more of:

  • SMTP/email notifications
  • Webhook notifications
  • Gotify/ntfy/Discord/Slack-style integrations
  • A generic HTTP notification endpoint
  • Optional UI-visible alerts/status badges for failed accounts/jobs

The main feature request is not necessarily tied to SMTP only. SMTP/email alerts would be very useful, but a generic webhook option would also make it easy to integrate Bichon with existing monitoring systems.

Purpose / Use Case

Bichon is useful as a mail archive, but if a scheduled download job fails silently, the archive can become outdated without the admin noticing.

In my case, I am using Bichon to archive mail from Gmail/IMAP accounts. If an app password is revoked, OAuth authorization stops working, Gmail starts throttling IMAP access, or a scheduled sync job fails, I would like to be notified automatically instead of having to manually check Docker logs or the UI.

This is especially important for long-running/self-hosted archive setups where the expectation is that Bichon keeps syncing in the background over time.

The feature would help admins quickly detect problems such as:

  • IMAP authentication failure
  • Missing/invalid password or app password
  • Expired/revoked OAuth token
  • IMAP server connection failure
  • Provider throttling/rate limiting
  • Repeated scheduled job failures
  • Accounts that have not synced successfully for a configurable period

Additional Information (optional)

A possible implementation could be:

  • Add a notification settings page where administrators can configure SMTP and/or webhook targets.
  • Add per-account or global alert rules, for example:
  • Alert after 1 failed sync
  • Alert after X consecutive failures
  • Alert if account has not synced successfully for X hours/days
  • Include useful details in the alert:
  • Account/email address
  • Mailbox/folder if relevant
  • Job name/type
  • Error message
  • Last successful sync time
  • Time of failure
  • Add a “Send test notification” button.
  • Optionally support both global notifications and per-account notification settings.

This would make Bichon much easier to operate as a reliable long-term mail archiving service.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions