Tempik — Disposable Temp Mail on Cloudflare Workers

Tempik is a self-hosted disposable email service that runs entirely on Cloudflare Workers — no VPS required. It uses Cloudflare Email Workers to receive inbound email, D1 for storage, and serves a clean web UI from the edge.

Repo: github.com/hirotomasato/tempik

How it works

Sender → Cloudflare MX → Email Worker (email handler)
                                  │
                                  ▼
                          D1 Database (SQLite)
                                  │
                                  ▼
                   Worker HTTP handler → Web UI + API

• No VPS — everything runs on Cloudflare's edge
• No Postfix — Cloudflare Email Workers handle SMTP ingestion natively
• No Docker — just wrangler deploy
• Zero cost — fits within Cloudflare's free tier

Prerequisites

Before you start, you need:

Step 1 — Clone & install dependencies

git clone https://github.com/hirotomasato/tempik.git
cd tempik
npm install

Step 2 — Login to Cloudflare

npx wrangler login

This opens a browser window. Log in with your Cloudflare account and approve the OAuth scopes.

What scopes are needed? Wrangler will request permissions for Workers, D1, Email Routing, Pages, and more. You must approve all of them so the CLI can create the database and deploy the worker.

Verify you're logged in:

npx wrangler whoami

Step 3 — Configure wrangler.toml

Open wrangler.toml and replace the placeholder values with your own:

name = "tempik"
main = "src/index.ts"
compatibility_date = "2025-06-01"

# Set to false when using your own domain (skip workers.dev)
workers_dev = false

# D1 Database — leave database_id empty for now, we'll fill it in Step 4
[[d1_databases]]
binding = "DB"
database_name = "tempik-db"
database_id = ""

# Email Worker
[email]
action = "process"

# Custom domain — CHANGE THIS to your own domain
[[routes]]
pattern = "tempik.YOU