Skip to content

self-hosted simple disposable email system (php)

Notifications You must be signed in to change notification settings

VPNSox/disposable-email

 
 

Repository files navigation

self-hosted disposable email system

This disposable email solution can be hosted on your own standard PHP-webhoster. All you need is PHP with mailparse extension and "Pipe to a Program" functionality. The system is as simple as possible, with minimal codebase and complexity.

Note: there is also an IMAP version without database and that does not need "pipe to command". https://github.com/synox/disposable-mailbox

Usage

When accessing the web-app a random email address is generated for you. The page will reload until emails have arrived. You can delete emails and see the original sourcecode.

Example Screenshot

screenshot

Licence

Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)

https://creativecommons.org/licenses/by-nc/4.0/

Requirements

Installation

  • assure the mailparse extension is installed. The following command should not print any error:

      <?php mailparse_msg_create(); ?>
    
  • Clone/download this repository

  • run composer install

Configuration

  • forward/pipe email to the php script app/pipe_input.php (e.g. cpanel docs)
  • (optionally) configure a different database like mysql in app/config.php
  • (optionally) configure the link redirection provider (to keep the existence of your installation secret) in app/config.php

TODO

  1. security audit against xss/sqli

development environment

There is a Vagrantfile to be used with vagrant.

OSX dependencies

  • install php: https://github.com/Homebrew/homebrew-php
  • add php to path: fish config: set PATH /usr/local/opt/php55/bin $PATH
  • pecl install mailparse
  • (see "php --ini" for file: ) echo "extension=mailparse.so" >> /usr/local/etc/php/5.5/php.ini

See also

About

self-hosted simple disposable email system (php)

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • CSS 46.1%
  • PHP 28.8%
  • HTML 18.4%
  • JavaScript 4.7%
  • Shell 1.4%
  • ApacheConf 0.6%