jmail

Free Disposable Temp Mail on Cloudflare Workers

jmail is a free, self-hosted disposable email service that runs entirely on Cloudflare Workers. No VPS, no Postfix, no Docker. It receives inbound email via Cloudflare Email Routing, stores messages in D1 (SQLite), and serves a clean web UI from the edge.

Live demo: mail.atiku.web.id

Features

Anonymous sessions — no sign-up, no tracking. Each browser gets its own isolated session via localStorage.
Auto-sync 5s — messages appear automatically without manual refresh.
Multi-domain — configure multiple mail domains (e.g. atiku.web.id, lalekne.web.id).
Ads-ready — optional AdSense slots (header/inlist/footer) or custom HTML ad injection. Disabled by default.
Theme customization — 5 CSS variable overrides via env vars. No code changes needed.
Vanilla JS frontend — zero framework dependencies. Just HTML, CSS, and plain JavaScript.
Zero dependencies beyond Hono + PostalMime — minimal supply chain.
Runs on Cloudflare free tier — Workers, D1, Email Routing, all free.

Quick Start

1. Clone & install

git clone https://github.com/josskixg/jmail.git
cd jmail
npm install

2. Login to Cloudflare

npx wrangler login

3. Configure environment variables

Edit wrangler.toml and fill in your values. See Configuration for all variables.

4. Create the D1 database

npx wrangler d1 create jmail-db

Copy the database_id into your wrangler.toml, then apply the schema:

npx wrangler d1 execute jmail-db --remote --file=src/db/schema.sql

5. Deploy

npx wrangler deploy

Set up Email Routing on your domain to start receiving emails.

Configuration

All environment variables are set in wrangler.toml under [vars].

App Settings

Variable	Type	Default	Description
`APP_NAME`	string	`"jmail"`	Display name shown in the UI
`MAIL_DOMAIN`	string	`"atiku.web.id"`	Comma-separated list of allowed mail domains
`WEB_HOST`	string	`"mail.atiku.web.id"`	Hostname of the web frontend
`TAGLINE`	string	`"Free Disposable Temporary Email & Anonymous Inbox"`	Tagline below the app name
`FOOTER_TEXT`	string	`"CREATED BY JMail"`	Footer attribution text

SEO Meta

Variable	Type	Default	Description
`META_KEYWORDS`	string	`"jmail, temp mail, ..."`	Content for `<meta name="keywords">`
`META_AUTHOR`	string	`"JMAIL"`	Content for `<meta name="author">`

Ads (disabled by default)

Variable	Type	Default	Description
`ADS_ENABLED`	string	`"false"`	Set `"true"` to enable ad slots
`ADS_CLIENT`	string	`""`	AdSense publisher ID (e.g. `ca-pub-1234567890`)
`ADS_SLOT_HEADER`	string	`""`	AdSense slot ID for header
`ADS_SLOT_INLIST`	string	`""`	AdSense slot ID between inbox rows
`ADS_SLOT_FOOTER`	string	`""`	AdSense slot ID for footer
`ADS_CUSTOM_HEADER`	string	`""`	Custom HTML/JS for header ad (overrides AdSense)
`ADS_CUSTOM_INLIST`	string	`""`	Custom HTML/JS for in-list ad (overrides AdSense)
`ADS_CUSTOM_FOOTER`	string	`""`	Custom HTML/JS for footer ad (overrides AdSense)

Theme (optional)

Leave empty to use the default flower theme. Each value maps to a CSS custom property.

Variable	CSS Property	Controls
`THEME_BG`	`--bg-canvas`	Background color
`THEME_PRIMARY`	`--pink-flower`	Primary brand color
`THEME_PRIMARY_SOFT`	`--pink-soft`	Primary color lighter shade
`THEME_ACCENT`	`--yellow-flower`	Accent/secondary color
`THEME_ACCENT_SOFT`	`--yellow-soft`	Accent color lighter shade

Example Palettes

Cyberpunk:

THEME_BG = "#0a0a0f"
THEME_PRIMARY = "#ff2d95"
THEME_PRIMARY_SOFT = "#ff2d9533"
THEME_ACCENT = "#00f0ff"
THEME_ACCENT_SOFT = "#00f0ff33"

Forest:

THEME_BG = "#0f1a0f"
THEME_PRIMARY = "#2d8a4e"
THEME_PRIMARY_SOFT = "#2d8a4e33"
THEME_ACCENT = "#c4a35a"
THEME_ACCENT_SOFT = "#c4a35a33"

Project Structure

jmail/
├── wrangler.toml
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts                          # Entry point: fetch() + email() handlers
    ├── config/
    │   ├── defaults.ts                   # Default config values
    │   └── index.ts                      # Config/env loading
    ├── api/
    │   ├── routes.ts                     # Hono router combining all API modules
    │   ├── config.ts                     # GET /api/config
    │   ├── session.ts                    # GET /api/session
    │   ├── inboxes.ts                    # GET/POST /api/inboxes, DELETE /api/inboxes/:address
    │   ├── messages.ts                   # GET /api/inboxes/:address/messages
    │   ├── system.ts                     # GET /api/stats, GET /api/health
    │   └── helpers.ts                    # Shared types and middleware
    ├── email/
    │   └── handler.ts                    # PostalMime → D1 email parser
    ├── db/
    │   ├── schema.sql                    # D1 table definitions
    │   └── queries.ts                    # Typed query functions
    ├── utils/
    │   └── random-address.ts             # Human-like random email generator
    └── web/
        ├── index.html                    # Frontend UI
        ├── styles.css                    # Dark theme styles
        ├── docs.html                     # In-app API docs page
        ├── icon.svg                      # App icon
        ├── og-image.png                  # Open Graph preview image
        └── js/
            ├── app.js                    # Main app logic
            ├── api.js                    # API client wrapper
            ├── config.js                 # Config fetching/caching
            ├── inbox.js                  # Inbox management
            ├── messages.js               # Message display
            ├── canvas.js                 # Background animation
            ├── toast.js                  # Notification toasts
            └── ads.js                    # Ad slot loader

Email Routing Setup

After deploying, configure Cloudflare Email Routing to receive inbound mail.

1. Enable Email Routing

In the Cloudflare Dashboard:

Go to Workers & Pages → select your Worker → Settings → Triggers
Under Domains & Routes, confirm your custom domain is listed
Go to Email → Email Routing on your domain
Enable Email Routing (this creates the required MX and DNS records automatically)

2. Add Catch-All Route

Go to Email → Email Routing → Routing rules
Create a Catch-all address rule
Set the destination to Send to a Worker → select your Worker

3. SPF Record (recommended)

Add a TXT record to improve email deliverability:

Type	Name	Content
TXT	`@`	`v=spf1 include:_spf.mx.cloudflare.net ~all`

Verify

Send an email to any address at your domain. If routing is working, the Worker's email() handler processes it and stores it in D1.

API Overview

jmail exposes a REST API at /api/ with 8 endpoints:

Method	Endpoint	Description
`GET`	`/api/config`	Public app config (branding, ads, theme)
`GET`	`/api/session`	Create or retrieve an anonymous session
`GET`	`/api/inboxes`	List inboxes linked to your session
`POST`	`/api/inboxes`	Create a new inbox (or claim an existing one)
`DELETE`	`/api/inboxes/:address`	Remove an inbox from your session
`GET`	`/api/inboxes/:address/messages`	Fetch messages for an inbox
`GET`	`/api/stats`	Public stats (total inboxes, messages, domains)
`GET`	`/api/health`	Health check

Full API documentation with curl examples: API.md

Tech Stack

Layer	Tech
Runtime	Cloudflare Workers
Router	Hono
Email parsing	PostalMime
Database	Cloudflare D1 (SQLite)
Static hosting	Cloudflare Workers Assets (edge CDN)
Language	TypeScript
Frontend	Vanilla HTML/CSS/JS

Commands

Command	Description
`npm run deploy`	Deploy Worker + static assets
`npm run db:migrate`	Apply schema to production D1
`npm run db:local`	Apply schema to local D1
`npx wrangler dev`	Run Worker locally
`npx wrangler tail`	Stream live logs

Documentation

Full documentation site: josskixg.github.io/jmail

License

MIT

Developed by masantoid

Navigation Menu

Repository files navigation

jmail

Features

Quick Start

1. Clone & install

2. Login to Cloudflare

3. Configure environment variables

4. Create the D1 database

5. Deploy

Configuration

App Settings

SEO Meta

Ads (disabled by default)

Theme (optional)

Example Palettes

Project Structure

Email Routing Setup

1. Enable Email Routing

2. Add Catch-All Route

3. SPF Record (recommended)

Verify

API Overview

Tech Stack

Commands

Documentation

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
.github/workflows		.github/workflows
docs		docs
src		src
.gitignore		.gitignore
API.md		API.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
wrangler.toml		wrangler.toml

Folders and files

Latest commit

History

Repository files navigation

jmail

Features

Quick Start

1. Clone & install

2. Login to Cloudflare

3. Configure environment variables

4. Create the D1 database

5. Deploy

Configuration

App Settings

SEO Meta

Ads (disabled by default)

Theme (optional)

Example Palettes

Project Structure

Email Routing Setup

1. Enable Email Routing

2. Add Catch-All Route

3. SPF Record (recommended)

Verify

API Overview

Tech Stack

Commands

Documentation

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages