[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Cloudflare Email Relay

A multi-tenant Cloudflare Email Routing Worker that stores every inbound message and pushes it to the right Odoo or Frappe instance with durable retries.

[Open source](/open-source/)

Cloudflare Email Relay

GeneralActiveMIT

[View on GitHub (opens in a new tab)](https://github.com/Avunu/cloudflare-email-relay)[Documentation (opens in a new tab)](https://docs.avunu.net/cloudflare-email/)

PlatformGeneral

LicenseMIT

StatusActive

Repository[Avunu/cloudflare-email-relay](https://github.com/Avunu/cloudflare-email-relay)

Part ofCloudflare Email

Used in[Professional services](/work/avunu-erp/)

The Cloudflare Email Relay is the inbound half of Avunu's Cloudflare Email suite. Cloudflare Email Routing hands each message to this Worker, which stores it and pushes it to the ERP that owns the recipient's domain: an Odoo database running `mail_cloudflare` or a Frappe site running `cloudflare_email_delivery`. An ERP outage, a wrong secret, or a bad deploy can delay a message, but it can't lose one. It's for teams running several ERP instances on Cloudflare-hosted domains who want to drop IMAP mailboxes entirely.

## Features

**Store first.** Each message is written to R2 before anything else happens. If storage fails, Cloudflare tells the sending server to retry.

**Durable delivery.** One SQLite-backed Durable Object per tenant delivers messages oldest first, with back-off and retention you can tune.

**Signed pushes.** Every attempt is an HTTPS POST of the raw message, signed with HMAC-SHA256 and timestamped. Optional Cloudflare Access service tokens are supported.

**Multi-tenant.** One Worker serves many ERP instances, routed by recipient domain, including wildcard subdomains. Unknown or disabled domains are rejected at SMTP time.

**Ops API** per tenant, behind a bearer token, to list, inspect, retry, and delete deliveries.

**Library, not app.** Deployments are thin wrappers with a tenant table, and the same validation schemas run in CI.

## Getting started

The relay is published as an npm package. A deployment is a few lines of wrapper code, a `tenants.json`, and a `wrangler.jsonc`, and it needs the Workers Paid plan. The [README](https://github.com/Avunu/cloudflare-email-relay#deployment) documents the tenant model, the inbound contract, and deployment. Pair it with the [Frappe](/open-source/cloudflare_email_delivery/) or [Odoo](/open-source/odoo-email-messaging/) adapter.

Highlights

Every message stored in R2 before delivery is attemptedPer-tenant retry queues on Durable ObjectsHMAC-signed HTTPS pushes to Odoo and FrappeUnknown domains rejected at SMTP time, never dropped silentlyOps API to inspect, retry, and delete deliveries per tenant

Related projects

[All open-source projects](/open-source/)

[WordPress Cloudflare Email](/open-source/wordpress-cloudflare-email/)

Active

Routes all WordPress email through the Cloudflare Email Sending API and keeps a searchable log of every message, with no settings screen.

MIT[GitHub](https://github.com/Avunu/wordpress-cloudflare-email)

[Odoo Email and Messaging](/open-source/mail-addons/)

Active

Odoo 18 modules that send and receive email through Cloudflare and run two-way Twilio SMS and MMS conversations inside Discuss.

AGPL-3.0-or-later[GitHub](https://github.com/Avunu/mail-addons)

[Cloudflare Email Delivery](/open-source/cloudflare_email_delivery/)

Active

Send and receive Frappe and ERPNext email through Cloudflare, with no SMTP or IMAP provider in the loop.

MIT[GitHub](https://github.com/Avunu/cloudflare_email_delivery)

Need help with it?

Need this implemented? We run the relay for clients as part of managed infrastructure.

[Explore managed infrastructure](/services/infrastructure/)[Start a project](/start/)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
