mirror of
https://github.com/inventree/InvenTree.git
synced 2025-10-04 00:02:51 +00:00
ed45a4e5bf
* add warning that the log is useless by default * Add setting to enhance email log again * add missing test for #10109 * add test for delete protections * add error code * Update email.md * Update email.md
46 lines
1.9 KiB
Markdown
46 lines
1.9 KiB
Markdown
---
|
|
title: Email Configured
|
|
---
|
|
|
|
## Email Settings
|
|
|
|
InvenTree can be configured to send emails to users, for various purposes.
|
|
|
|
To enable this, email configuration settings must be supplied to the InvenTree [configuration options](../start/config.md#email-settings).
|
|
|
|
!!! info "Functionality might be degraded"
|
|
Multiple functions of InvenTree require functioning email delivery, including *Password Reset*, *Notififications*, *Update Infos*
|
|
|
|
### Outgoing
|
|
|
|
Mail can be delivered through various ESPs and SMTP. You can only configure one delivery method at a time.
|
|
|
|
### Incoming
|
|
|
|
Mail can be received though various ESPs, POP3 and IMAP.
|
|
|
|
When using POP3/IMAP InvenTree removes email that were processed. This is to prevent duplicate processing of the same email. You can specify a archive folder, that mails should be moved to after processing. This is useful for retaining manual access.
|
|
|
|
### Supported ESPs
|
|
|
|
InvenTree uses django-anymail to support various ESPs. A full list of supported ESPs can be found in [their docs](https://anymail.dev/en/stable/esps/).
|
|
|
|
Most popular providers are supported:
|
|
|
|
- Amazon SES
|
|
- Brevo (EU)
|
|
- Postal (Self hosted)
|
|
- Mailgun
|
|
- Postmark
|
|
- SendGrid
|
|
|
|
### Logging / Admin Insights
|
|
|
|
Superusers can view the email log in the [Admin Center](./admin.md#admin-center). This is useful for debugging and tracking email delivery / receipt.
|
|
|
|
!!! warning "Warning"
|
|
By default, email logs are cleaned after 30 days. This can be configured in the [InvenTree settings](../settings/global.md#server-settings).
|
|
If your organization is bound by business record retention laws or rules, you should ensure the retention of mail logs is set accordingly via a global override for the setting to ensure proper compliance. E.g. records in connection with commercial activity in the EU often have to be kept for over 5 years. Check requirements with proper sources for your region.
|
|
|
|
{{ image("admin/email_settings.png", "Email Control Pane") }}
|