𝐕𝐌𝐀𝐈𝐋.𝐃𝐄𝐕

Discord · English | 简体中文

Temporary email service build with email worker.

Features

• 🎯 Privacy-friendly, no registration required, out-of-the-box
• ✈️ Support email sending and receiving
• ✨ Support saving passwords and retrieving email addresses
• 😄 Support multiple domain name suffixes
• 🚀 100% open source, quick deployment, pure Cloudflare solution, no server required

Principles：

• Receiving emails (Cloudflare Email Worker)
• Display email (Vite + React on Cloudflare Pages)
• Mail Storage (Cloudflare D1)
• Node.js >= 18

Worker receives email -> saves to D1 database -> client queries email

Self-hosted Tutorial

This project is now fully based on Cloudflare Pages and Cloudflare D1, which greatly simplifies the deployment process. All you need is a domain name hosted on Cloudflare.

Requirements

• Cloudflare account and a domain name hosted on Cloudflare
• Local installation of Node.js (version >= 18.x) and pnpm

Automatic Deployment (Recommended)

This project includes a pre-configured GitHub Action workflow to help you automatically deploy the vMail application to Cloudflare.

For detailed steps, please refer to the GitHub Action Auto-Deployment Tutorial.

Manual Deployment Steps

1. Clone the project locally

   git clone https://github.com/oiov/vmail
   cd vmail
   pnpm install
   

2. Create a Cloudflare D1 Database Create a D1 database in the Cloudflare dashboard or using the Wrangler CLI.

3. Configure wrangler.toml Replace the ${...} placeholders in the wrangler.toml file in the root directory with your Cloudflare and D1 configuration information. You can also set these values through environment variables in Cloudflare Pages.

4. Build and Deploy

   # Build the frontend application
   pnpm run build
   
   # Deploy to Cloudflare
   pnpm run deploy
   

   Wrangler will automatically handle the deployment of frontend static assets and the Worker, and apply database migrations according to the configuration.

5. Configure Email Routing Rules In your Cloudflare domain management interface, go to Email -> Email Routing -> Routes, set up a Catch-all rule, and set the action to Send to a Worker, selecting the Worker you just deployed.

Local development

1. Copy the environment variable file

   # This command creates a local environment variable file that wrangler dev will load automatically
   cp .env.example .env
   

2. Fill in local environment variables Fill in the necessary environment variables in the .env file, especially D1_DATABASE_ID, etc. You need to create a D1 database in Cloudflare for local development first.

3. Start the development server

   pnpm run dev
   

   This command starts both the frontend Vite development server and the local Wrangler Worker environment at the same time.

Community Group

• Discord: https://discord.gg/d68kWCBDEs

License

GNU General Public License v3.0

Star History