whatisgithub

What is cloud-mail?

maillab/cloud-mail — explained in plain English

Analysis updated 2026-05-18

12,732JavaScriptAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

In one sentence

A free, self-hosted email service that runs on Cloudflare. Create custom email addresses, send and receive messages, and manage users through a web dashboard.

Mindmap

mindmap
  root((repo))
    What it does
      Send and receive email
      Web dashboard access
      Extract verification codes
      Notify on new email
    Tech stack
      Cloudflare Workers
      Vue 3 and Hono
      Cloudflare D1 database
      R2 object storage
    Use cases
      Custom domain email
      Catch signup codes
      Team email management
    Requirements
      A domain name
      Cloudflare account
      Resend account

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a custom email address using your own domain name.

USE CASE 2

Automatically extract signup verification codes from incoming emails.

USE CASE 3

Manage email accounts for a team with role-based access and storage limits.

USE CASE 4

Get Telegram notifications when new emails arrive in your inbox.

What is it built with?

JavaScriptCloudflare WorkersVue 3HonoDrizzleCloudflare D1Cloudflare R2Element Plus

How does it compare?

maillab/cloud-mailadvplyr/audiobookshelfmailcow/mailcow-dockerized
Stars12,73212,74112,751
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audienceops devopsgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Cloudflare account, a custom domain, and a Resend account for sending outgoing emails.

You can use, copy, and modify this software freely for any purpose, including commercial use, as long as you include the original copyright notice.

So what is it?

Cloud Mail is a self-hosted email service that runs on Cloudflare's infrastructure. With just a domain name, you can create multiple email addresses and manage them through a web interface that works on both desktop and mobile browsers. The project is built in JavaScript and aims to keep costs low by relying on Cloudflare's serverless platform instead of a traditional server. The service supports sending and receiving emails, including attachments. Outgoing email is handled through a service called Resend, and you can send to multiple recipients at once, embed images, and attach files. Incoming attachments are stored using Cloudflare R2 object storage. When a new email arrives, the system can forward a notification to a Telegram bot or another email address. It also uses Cloudflare's Workers AI to automatically detect and extract verification codes from incoming messages, which is handy for account sign-ups. On the admin side, there is role-based access control so you can manage users, limit what they can do, and restrict how much storage or how many resources they consume. An open API lets you create users in bulk and search through emails with multiple filters. The dashboard includes data visualizations powered by ECharts, showing system activity and email growth over time. You can also customize the site title, login background, and transparency settings. A human verification step called Turnstile is integrated to block automated bot registrations. The technology stack combines several pieces. The backend runs on Cloudflare Workers using the Hono web framework and Drizzle for database access. Data is stored in Cloudflare D1, with Cloudflare KV serving as a cache. The frontend is built with Vue 3 and the Element Plus component library. The codebase is split into a backend folder for the worker and a frontend folder for the Vue application, each with its own configuration and dependencies. The project is released under the MIT license and has a Telegram group for community discussion. Deployment instructions and a live demo are linked from the README.

Copy-paste prompts

Prompt 1
Help me deploy Cloud Mail on Cloudflare Workers. I have a domain name, a Cloudflare account, and a Resend API key. Walk me through the setup steps.
Prompt 2
How do I configure the Telegram bot notification feature in Cloud Mail so I get an alert whenever a new email arrives?
Prompt 3
I want to customize the Cloud Mail login page with my own site title and background image. Show me where to change these settings.
Prompt 4
Explain how to use the Cloud Mail API to bulk-create new email users and set storage limits for each one.

Frequently asked questions

What is cloud-mail?

A free, self-hosted email service that runs on Cloudflare. Create custom email addresses, send and receive messages, and manage users through a web dashboard.

What language is cloud-mail written in?

Mainly JavaScript. The stack also includes JavaScript, Cloudflare Workers, Vue 3.

What license does cloud-mail use?

You can use, copy, and modify this software freely for any purpose, including commercial use, as long as you include the original copyright notice.

How hard is cloud-mail to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cloud-mail for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.