git404hub

what is tempmail fr?

xiaozhou26/tempmail — explained in plain English

Analysis updated 2026-05-18

30GoAudience · developer

tl;dr

tempmail is a self hosted Go backend that turns a domain routed through Cloudflare into disposable email addresses, fetching mail on demand from a relay inbox via IMAP or Microsoft Graph.

vibe map

mindmap
  root((tempmail))
    What it does
      Temporary mailboxes
      On demand fetch
      REST API
    Tech stack
      Go
      SQLite
      Cloudflare Email Routing
      IMAP and Graph
    Use cases
      Verification codes
      Signup testing
      Self hosted relay
    Audience
      Developers

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 make with this?

VIBE 1

Spin up disposable email addresses on your own domain to receive one time verification codes.

VIBE 2

Run a self hosted temporary mailbox API for testing signup flows without using a third party service.

VIBE 3

Forward all mail on a domain through Cloudflare Email Routing to a single relay inbox that tempmail reads on demand.

VIBE 4

Deploy a small Docker or systemd service that issues and expires temporary mailboxes automatically.

what's the stack?

GoSQLiteCloudflare Email RoutingIMAPMicrosoft Graph

how it stacks up fr

xiaozhou26/tempmaildevelopersdigest/aws-ec2-cuda-ollamahoophq/alcatraz
Stars303030
LanguageGoGoGo
Last pushed2024-08-03
MaintenanceStale
Setup difficultyhardeasy
Complexity4/52/5
Audiencedeveloperops devopsdeveloper

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

in plain english

tempmail is a self hosted backend for running your own temporary email addresses on a domain you own, built with Go and a small embedded SQLite database so it needs no separate database server. It exposes a REST API for creating, checking, and deleting disposable mailboxes and their messages. The way it works is that you point your domain at Cloudflare and set up Cloudflare Email Routing so any address at your domain forwards incoming mail to one real relay mailbox, such as a Gmail, Outlook, or Firstmail account. The tempmail service does not sit there constantly checking that relay mailbox in the background. Instead, only when a client calls the API to check a mailbox's messages does the service reach into the relay mailbox over IMAP or Microsoft Graph and pull the relevant mail on demand, then route it back based on which address it was sent to. This on demand approach avoids wasting Cloudflare Worker usage and keeps the relay mailbox from being hammered with requests, since repeated checks within about a second are served from the local database instead of triggering a fresh fetch. For personal Outlook accounts the project recommends using Microsoft Graph rather than IMAP, since IMAP can be unreliable there, while Gmail and providers like Firstmail work well over plain IMAP with an app password. An optional webhook endpoint is also available for setups that prefer a push based Email Worker instead. The project can run as a plain binary, inside Docker with an image published to GitHub Container Registry, or as a systemd service, and tagged releases trigger GitHub Actions to build multi platform binaries and container images automatically. A typical use is generating a short lived mailbox to receive a single verification code, then polling the messages endpoint every one to three seconds until it arrives.

prompts (copy fr)

prompt 1
Help me set up Cloudflare Email Routing catch-all forwarding to a Firstmail relay mailbox for use with this tempmail backend.
prompt 2
Write a script that creates a tempmail mailbox via the API and polls for a verification code every two seconds.
prompt 3
Explain the difference between the IMAP and Microsoft Graph modes in this tempmail config and when to use each.
prompt 4
Show me the systemd service file and Docker run command needed to deploy this tempmail backend on a VPS.

Frequently asked questions

what is tempmail fr?

tempmail is a self hosted Go backend that turns a domain routed through Cloudflare into disposable email addresses, fetching mail on demand from a relay inbox via IMAP or Microsoft Graph.

What language is tempmail written in?

Mainly Go. The stack also includes Go, SQLite, Cloudflare Email Routing.

Who is tempmail for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.