TempMail VPS
Login
100% Private REST API Mail Server

API-First VPS
Temporary Email

Deploy a robust temporary email testing node on your own VPS. Built specifically to generate random mailboxes, receive testing emails, parse attachments, and extract verification OTP codes programmatically via standard REST endpoints.

REST API

JSON Ingestion

OTP Parser

Auto regex extraction

Attachments

Direct server downloads

HTTP REQUESTGET /api/domains

Fetch a list of all active domains available for generating temporary email addresses.

Request Snippet (curl command)
curl -X GET http://localhost:8081/api/domains
Expected Response (JSON Object)
{
  "domains": [
    "tempemail.vps"
  ]
}

Robust Architecture

Designed for Programmatic Mail Testing

A self-hosted API node is perfect for automating registration, password recovery, and email verification testing.

Programmatic REST API

Connect and control your mailboxes completely via HTTP APIs. Instantly query incoming mail objects, sender metadata, and raw headers in standard JSON.

Automated OTP Parsing

The parser automatically scans inbound mail subjects and body texts for 4-6 digit numeric authentication codes. Retrieve clean verification codes instantly.

Zero-Log VPS Privacy

Host the server on your own node. Email records, raw bodies, and attachments remain entirely under your local file paths. No external tracking logs.

MIME Attachments

Integrated SMTP parser automatically isolates files from base64 streams and saves them to local storage. Retrieve raw media resources directly over API.

Transient Routing

Generate random mailbox prefixes on demand. The server captures and routes emails to dynamic addresses instantly without prior inbox setup.

DKIM Compliance

Integrated support for generating cryptographically signed DKIM signatures. Easily test bidirectional mailing integrations with full SPF verification.

Developer API

Integrate with Testing Scripts in Minutes

The VPS email server hosts a lightweight HTTP listener. Write scripts to generate transient mail addresses, submit them in sign-up pages, query the inbox for verification codes, and fetch attachments programmatically.

Regex-extracted OTP values in standard fields
Supports automated attachments retrieval and download
No account signup or token config required for local testing
Available REST API EndpointsPayload Type
GET/api/domains
JSON Array [Domains]
GET/api/mailbox/generate?domain=...
JSON Object
GET/api/mailbox/custom?name=...&domain=...
JSON Object
GET/api/mailbox/:email
JSON Array [Emails]
DELETE/api/mailbox/:email
JSON Object
DELETE/api/mailbox/:email/:mailId
JSON Object
GET/api/attachments/:filename
Binary payload stream

Console Gateways

Choose Your Gateway Portal

Select one of the ready consoles below to start capturing emails.

Public Network

Live Console

Connects to the internet-facing SMTP server. Best for capturing real emails sent from platforms like Gmail, GitHub, or AWS to your configured public domains.

Port: 25 (SMTP)
ACTIVE
Latency: ~5ms
99.98%
Launch Live Console
Private MailboxAuth Protected

Mail Box

Access your dedicated project mailbox. View all incoming emails for your account with persistent, long-term storage. Manage your access credentials securely via the admin panel.

Auth: Required
SECURE
Persistent Storage
ACTIVE
Open Mail Box
System ControlAuth Protected

Admin Panel

Protected administration space. Clean up database records, inspect storage paths, configure incoming whitelist domains, and generate cryptographic DKIM keys.

Scope: Server Control
SECURE
DKIM Keys
SIGNED
Access Admin Settings

Support Resources

Frequently Asked Questions

Got questions about self-hosting, configuration, or API limits? Here are common answers.

It runs a lightweight SMTP receiver listening on Port 25 (public mail network) and Port 1025 (local sandbox loop). Any mail dispatched to your configured MX domain routes directly into our local Node/Bun parser, which stores them into a lightweight SQLite database.

You need a Linux or Windows VPS with public port 25 open, a domain name where you can configure DNS records (specifically an MX record pointing to your server's IP), and Bun or Node.js runtime installed.

Yes, entirely. Since it's self-hosted, no email logs or attachments are processed by third-party APIs. Your data remains stored locally inside your VPS sqlite files, which you control.

When a mail arrives, the backend engine processes the plain text and HTML payloads. It applies standard Regex patterns to locate 4-6 digit numeric codes, matching common formatting patterns from verification companies, and indexes them in a secondary collection for fast lookup.

Yes! The admin settings console allows configuration of incoming whitelist parameters to filter out spam or restrict incoming traffic to only match specific test domains.

Support & Feedback

Contact Server Administrator

Need help configuring DNS MX records, managing email storage volumes, or adjusting administrative settings? Get in touch with the system owner.

System Admin

Owner

Active & Available

admin@tempemail.vps
Send Email