Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 1.92 KB

readme.md

File metadata and controls

50 lines (33 loc) · 1.92 KB

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.

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

  • Clone/download this repository

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

      <?php mailparse_msg_create(); ?>
    

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