TMail - Disposable Email System PHP Script

TempMail is a complete, production-ready disposable email service built with Laravel 11 (backend API) and Vue 3 (frontend SPA). Similar to Temp-Mail.org or Guerrilla Mail, users receive an instant temporary inbox without needing to register.

Emails are received in real-time through a Postfix SMTP pipe on your own private VPS — giving you full ownership of the infrastructure. The inbox automatically refreshes every 10 seconds and securely displays HTML emails within an isolated iframe to prevent XSS attacks.

The admin dashboard includes everything you need: dashboard analytics powered by Chart.js, user management, domain and SMTP provider management, subscription plans, transactions, blacklists, abuse reports, audit logs, dynamic pages, ad banners, welcome email templates, and full SEO/branding settings — all manageable from the UI without any code changes.
It includes a comprehensive SETUP_GUIDE.md file covering every single step: Nginx configuration, SSL with Let's Encrypt, PHP 8.2, MySQL, Supervisor, Postfix pipe, DNS MX records, and 13 common errors with their exact fixes. A live demo is available at the demo URL.

Features

• Instant Disposable Emails: No registration or account creation required.
• Production-Ready SMTP Delivery: Receive real-time emails via a Postfix SMTP pipe deployed on your own VPS.
• Auto-Refreshing Inbox: The inbox automatically refreshes every 10 seconds.
• Secure HTML Rendering: Emails are displayed safely inside an isolated iframe to prevent XSS attacks.
• Quick Actions: One-click email address copying and integrated QR code popups.
• Flexible Email Customization: Easily change addresses using either random or custom usernames.
• Multi-Domain Support: Support for multiple domains with individual Active/Inactive toggles.
• REST API Access: Developer access featuring API keys that can be viewed, masked, or regenerated.
• Contact Form: Integrated contact form with backend inbox management for admins.
• Dynamic Pages: Admin-editable content pages (Privacy Policy, Terms of Service, FAQs).
• Ad Banner Management: Position-based ad banner management controlled via the admin panel.
• Social QR Codes: Display social media QR codes in the footer, managed by the admin.
• Welcome Email Templates: Built-in editor to customize welcome email templates.
• Comprehensive Admin Panel: Centralized management for Dashboard, Users, Emails, Domains, Providers, Subscription Plans, and Transactions.
• Advanced Analytics: Admin dashboard featuring live statistic cards and Chart.js line charts.
• Advanced Blacklist System: Block malicious activity by email, domain, IP address, or specific keywords.
• Abuse Report Management: Track and handle abuse reports with real-time status updates.
• Security Logs: Comprehensive admin activity logs and user login history.
• SEO Settings: Full control over meta titles, descriptions, OG images, robots.txt, and Google Search Console tags.
• Branding & Identity: Customize your site name, logo, favicon, social links, and copyright text.
• Automated XML Sitemap: Automatically generates and updates your XML sitemap.
• Rate Limiting: IP-based rate limiting and abuse protection to secure your infrastructure.
• Fully Responsive: Completely mobile-friendly design featuring a native-feeling bottom navigation bar.
• Multi-Provider SMTP: Manage and configure multiple SMTP providers simultaneously.
• System Health Check: Monitor and test your infrastructure's health directly from the admin panel.
• Detailed Deployment Guide: Includes a step-by-step SETUP_GUIDE.md covering 13 common troubleshooting solutions.

Requirements

System Requirements

• PHP: 8.2 or higher with the following extensions: pdo_mysql, mbstring, xml, curl, openssl, zip, gd, fileinfo, intl
• Database: MySQL 5.7+ or MariaDB 10.3+
• Package Managers: Composer 2.x, Node.js 18+, and npm 9+ (for building the frontend assets)
• Web Server: Nginx (recommended) or Apache with mod_rewrite enabled
• Operating System: Ubuntu 22.04 VPS or any Linux server (Windows is supported for local development via Mailpit)
• Domain: A domain name with full DNS management access (required for configuring MX records)
• Mail Server: Postfix (for real-time email delivery — complete setup instructions included)
• SSL Certificate: SSL/TLS required — Let's Encrypt (free) supported with step-by-step certbot commands included in the guide
• Process Manager: Supervisor (required to run the Laravel scheduler and queue workers as background daemons)

Instructions

Quick Setup Overview

1. Extract Source Files: Unzip the source files into your server directory (e.g., /var/www/yoursite).
2. Install Backend Dependencies: Run composer install --no-dev inside the backend/ directory.
3. Configure Environment: Copy backend/.env.example to backend/.env and configure your database credentials, APP_KEY, and APP_URL.
4. Database Setup: Run php artisan migrate, then import database.sql to populate default settings and the admin account.
5. Build Frontend: Navigate to the frontend directory and build the assets: Bash<b><b> </b></b>

   <code><b><b>
   cd frontend && npm install && npm run build
   </b></b></code>
   
   
   

   <b><b> </b></b>
6. <b><b><b>Deploy Frontend:</b> Copy the compiled files from <code>frontend/dist/ into your Nginx web root directory.
7. <b><b><b>Configure Nginx:</b> Set up Nginx to serve the frontend on ports 80/443, and reverse proxy <code>/api requests to Laravel running on port 8000.
8. <b><b><b>Process Management:</b> Set up Supervisor to keep the Laravel scheduler running continuously as a daemon. </b></b>
9. <b><b><b>Postfix Integration:</b> Configure Postfix to pipe incoming emails directly to the <code>php artisan inbound:receive command.
10. <b><b><b>DNS & Domains:</b> Add your domain in the Admin Panel → Domains, then point your domain's DNS MX records to your server's IP address. </b></b>
11. <b><b><b>Admin Login:</b> Log in to the Admin panel at <code>/admin/login using the default credentials provided in database.sql, and immediately change your password.

<b><b><b>Note:</b> All exact commands, configuration blocks, and 13 common troubleshooting fixes are fully detailed in the accompanying <b><code>SETUP_GUIDE.md file.

<b><b><br /></b></b>