[{"data":1,"prerenderedAt":173},["ShallowReactive",2],{"doc:cloudflare\u002Fmail":3},{"title":4,"description":5,"url":6,"markdownPath":7,"file":8,"section":9,"sectionTitle":10,"html":11,"toc":12,"navigation":32,"previous":171,"next":172},"Mail on Cloudflare","Connect a mail domain to your Cloudflare L4 Server with Cloudflare Email Routing and Email Sending, then create shared Mailboxes.","\u002Fdocs\u002Fcloudflare\u002Fmail","\u002Fdocs\u002Fcloudflare\u002Fmail.md","docs\u002Fcloudflare\u002Fmail.md","cloudflare","Cloudflare","\u003Cp>Mail is optional. A Cloudflare Server receives and sends email for its shared Mailboxes through Cloudflare \u003Cstrong>Email Routing\u003C\u002Fstrong> and \u003Cstrong>Email Sending\u003C\u002Fstrong> on a domain in your Cloudflare account. The installer does not set up mail; you connect a mail domain later from the Server's Settings.\u003C\u002Fp>\n\u003Cp>For using Mail day to day, see the \u003Ca href=\"\u002Fdocs\u002Fguides\u002Fmail\">Mail guide\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"before-you-start\">\u003Ca class=\"heading-anchor\" href=\"#before-you-start\">Before you start\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>The Server must \u003Cstrong>keep Cloudflare access\u003C\u002Fstrong> with permission for zones, DNS, Email Routing and Email Sending. The installer's OAuth grant has these. The pre-filled API token for updates does not. See \u003Ca href=\"\u002Fdocs\u002Fcloudflare\u002Faccess\">Cloudflare access\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>The domain must be in an active zone in the same Cloudflare account as the Server.\u003C\u002Fli>\n\u003Cli>You must be the Owner.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Without kept access, the Domains tab says email domains are managed by the Server operator.\u003C\u002Fp>\n\u003Cblockquote class=\"callout callout-warning\">\u003Cp class=\"callout-title\">Warning\u003C\u002Fp>\u003Cp>Connecting a domain turns on Cloudflare Email Routing for it and routes its mail to this Server. If the domain already receives mail through another provider, use a subdomain such as \u003Ccode>mail.example.com\u003C\u002Fcode> instead, so existing mail keeps working.\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"connect-a-mail-domain\">\u003Ca class=\"heading-anchor\" href=\"#connect-a-mail-domain\">Connect a mail domain\u003C\u002Fa>\u003C\u002Fh2>\n\u003Col>\n\u003Cli>In your Server, open \u003Cstrong>Server settings → Mail\u003C\u002Fstrong> and choose the \u003Cstrong>Domains\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003Cli>Select \u003Cstrong>Connect domain\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Choose the \u003Cstrong>Cloudflare zone\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>In \u003Cstrong>Mail domain\u003C\u002Fstrong>, enter the zone itself or a subdomain, for example \u003Ccode>mail.example.com\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Select \u003Cstrong>Connect\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cfigure class=\"doc-shot doc-shot-missing\">\u003Cdiv class=\"doc-shot-frame\" role=\"img\" aria-label=\"The Domains tab in Mail settings with the Connect domain form showing the Cloudflare zone select, the Mail domain field and the Connect button\">\u003Cspan class=\"doc-shot-label\">Screenshot coming soon\u003C\u002Fspan>\u003Cspan class=\"doc-shot-alt\">The Domains tab in Mail settings with the Connect domain form showing the Cloudflare zone select, the Mail domain field and the Connect button\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cfigcaption>Connect a mail domain\u003C\u002Ffigcaption>\u003C\u002Ffigure>\u003C\u002Fp>\n\u003Cp>The Server then:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>enables Cloudflare Email Routing for the domain;\u003C\u002Fli>\n\u003Cli>onboards the domain for Cloudflare Email Sending, or re-enables it if it was turned off;\u003C\u002Fli>\n\u003Cli>adds the Email Sending binding to its Worker.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>If the page shows \u003Cstrong>Sending is not set up yet\u003C\u002Fstrong>, mail can be received but the Server cannot send until the domain finishes connecting in Cloudflare. Check the domain's status under Email in your Cloudflare dashboard.\u003C\u002Fp>\n\u003Ch2 id=\"create-a-mailbox\">\u003Ca class=\"heading-anchor\" href=\"#create-a-mailbox\">Create a Mailbox\u003C\u002Fa>\u003C\u002Fh2>\n\u003Col>\n\u003Cli>In \u003Cstrong>Server settings → Mail\u003C\u002Fstrong>, choose the \u003Cstrong>Mailboxes\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003Cli>Select \u003Cstrong>New mailbox\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Enter the address and choose the domain, then select \u003Cstrong>Create mailbox\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Open the Mailbox to set its \u003Cstrong>Display name\u003C\u002Fstrong> and choose who has access.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Each Mailbox has its own access rules. People need a grant on the Mailbox plus \u003Cstrong>Read email\u003C\u002Fstrong> or \u003Cstrong>Send email\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2 id=\"disconnect-a-mail-domain\">\u003Ca class=\"heading-anchor\" href=\"#disconnect-a-mail-domain\">Disconnect a mail domain\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>On the \u003Cstrong>Domains\u003C\u002Fstrong> tab, select \u003Cstrong>Disconnect\u003C\u002Fstrong> next to the domain.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>If L4 created the domain's Email Sending configuration, it removes it again.\u003C\u002Fli>\n\u003Cli>When no mail domain remains, the Email Sending binding is removed from the Worker.\u003C\u002Fli>\n\u003Cli>Mailboxes and their history stay on the Server.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"limits\">\u003Ca class=\"heading-anchor\" href=\"#limits\">Limits\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Up to 10 attachments, 3 MB in total, per email. This keeps a message within Cloudflare Email Sending's 5 MiB limit once encoded.\u003C\u002Fli>\n\u003Cli>Sending external email from an Agent always needs human approval.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Cloudflare's own Email Routing and Email Sending limits and pricing apply. See \u003Ca href=\"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-routing\u002F\" rel=\"noopener\">Email Routing\u003C\u002Fa> in the Cloudflare docs.\u003C\u002Fp>\n\u003Ch2 id=\"related\">\u003Ca class=\"heading-anchor\" href=\"#related\">Related\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fguides\u002Fmail\">Mail guide\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fcloudflare\u002Fcustom-domain\">Custom domain\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n",[13,17,20,23,26,29],{"id":14,"text":15,"depth":16},"before-you-start","Before you start",2,{"id":18,"text":19,"depth":16},"connect-a-mail-domain","Connect a mail domain",{"id":21,"text":22,"depth":16},"create-a-mailbox","Create a Mailbox",{"id":24,"text":25,"depth":16},"disconnect-a-mail-domain","Disconnect a mail domain",{"id":27,"text":28,"depth":16},"limits","Limits",{"id":30,"text":31,"depth":16},"related","Related",[33,58,82,98,117,139,161],{"id":34,"title":35,"pages":36},"get-started","Get started",[37,40,43,46,49,52,55],{"title":38,"url":39},"What is L4","\u002Fdocs\u002Fget-started\u002Fwhat-is-l4",{"title":41,"url":42},"Choose how to run your Server","\u002Fdocs\u002Fget-started\u002Fchoose-how-to-run",{"title":44,"url":45},"Create a Server on Cloudflare","\u002Fdocs\u002Fget-started\u002Fcreate-on-cloudflare",{"title":47,"url":48},"Install on a VPS","\u002Fdocs\u002Fget-started\u002Finstall-on-a-vps",{"title":50,"url":51},"Connect to a Server","\u002Fdocs\u002Fget-started\u002Fconnect-a-server",{"title":53,"url":54},"Invite your team","\u002Fdocs\u002Fget-started\u002Finvite-your-team",{"title":56,"url":57},"Create your first Agent","\u002Fdocs\u002Fget-started\u002Ffirst-agent",{"id":9,"title":10,"pages":59},[60,63,66,69,72,73,76,79],{"title":61,"url":62},"L4 on Cloudflare","\u002Fdocs\u002Fcloudflare\u002Foverview",{"title":64,"url":65},"Cloudflare access","\u002Fdocs\u002Fcloudflare\u002Faccess",{"title":67,"url":68},"Costs and limits","\u002Fdocs\u002Fcloudflare\u002Fcosts-and-limits",{"title":70,"url":71},"Custom domain","\u002Fdocs\u002Fcloudflare\u002Fcustom-domain",{"title":4,"url":6},{"title":74,"url":75},"Update a Cloudflare Server","\u002Fdocs\u002Fcloudflare\u002Fupdates",{"title":77,"url":78},"Backups on Cloudflare","\u002Fdocs\u002Fcloudflare\u002Fbackups",{"title":80,"url":81},"Remove a Cloudflare Server","\u002Fdocs\u002Fcloudflare\u002Fremove-a-server",{"id":83,"title":84,"pages":85},"self-host","Self-host",[86,89,92,95],{"title":87,"url":88},"Run a Server on a VPS","\u002Fdocs\u002Fself-host\u002Fvps",{"title":90,"url":91},"Run a Server with Docker Compose","\u002Fdocs\u002Fself-host\u002Fdocker",{"title":93,"url":94},"Run a Server on Coolify","\u002Fdocs\u002Fself-host\u002Fcoolify",{"title":96,"url":97},"Compute Nodes","\u002Fdocs\u002Fself-host\u002Fcompute-nodes",{"id":99,"title":100,"pages":101},"concepts","Concepts",[102,105,108,111,114],{"title":103,"url":104},"Servers and the Shell","\u002Fdocs\u002Fconcepts\u002Fserver-and-shell",{"title":106,"url":107},"Accounts, Members and Roles","\u002Fdocs\u002Fconcepts\u002Faccounts-members-roles",{"title":109,"url":110},"Agents, Tasks and Runs","\u002Fdocs\u002Fconcepts\u002Fagents-tasks-runs",{"title":112,"url":113},"Files and backups","\u002Fdocs\u002Fconcepts\u002Ffiles-and-backups",{"title":115,"url":116},"Releases and updates","\u002Fdocs\u002Fconcepts\u002Freleases-and-updates",{"id":118,"title":119,"pages":120},"agents","Agents and MCP",[121,124,127,130,133,136],{"title":122,"url":123},"Agents overview","\u002Fdocs\u002Fagents\u002Foverview",{"title":125,"url":126},"Models and Providers","\u002Fdocs\u002Fagents\u002Fmodels-and-providers",{"title":128,"url":129},"Connect an MCP client","\u002Fdocs\u002Fagents\u002Fmcp",{"title":131,"url":132},"External agents","\u002Fdocs\u002Fagents\u002Fexternal-agents",{"title":134,"url":135},"Repositories and code work","\u002Fdocs\u002Fagents\u002Frepositories",{"title":137,"url":138},"Schedules","\u002Fdocs\u002Fagents\u002Fschedules",{"id":140,"title":141,"pages":142},"guides","Guides",[143,146,149,152,155,158],{"title":144,"url":145},"Chat","\u002Fdocs\u002Fguides\u002Fchat",{"title":147,"url":148},"Projects and Tasks","\u002Fdocs\u002Fguides\u002Fprojects-and-tasks",{"title":150,"url":151},"Mail","\u002Fdocs\u002Fguides\u002Fmail",{"title":153,"url":154},"Calls and Live","\u002Fdocs\u002Fguides\u002Fcalls",{"title":156,"url":157},"Notifications","\u002Fdocs\u002Fguides\u002Fnotifications",{"title":159,"url":160},"Telegram","\u002Fdocs\u002Fguides\u002Ftelegram",{"id":162,"title":163,"pages":164},"reference","Reference",[165,168],{"title":166,"url":167},"Glossary","\u002Fdocs\u002Freference\u002Fglossary",{"title":169,"url":170},"Troubleshooting","\u002Fdocs\u002Freference\u002Ftroubleshooting",{"title":70,"url":71},{"title":74,"url":75},1793304298142]