self-hosted disposable email service

Goals:

• easy to use: generate random name or use custom name, auto refresh
• easy to host: just php5 + imap extension
• easy to install: just copy some files
• minimal code base: minimal features and complexity

Quality/Status:

This is WORK IN PROGRESS (WIP) software, do not use it in production yet! It may lose your mails and people may gain access to your mails. There are still unsolved problems. Contributions are welcome!

You should sign up for the chat and you will be notified about issues and bugfixes:

Licence

disposable-mailbox by github:synox is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Webserver requirements

• php >=5.3.0
• imap extension
• apache 2 (but should work on any webserver)

Installation

1. assure the imap extension is installed. The following command should not print any errors:

    <?php print imap_base64("SU1BUCBleHRlbnNpb24gc2VlbXMgdG8gYmUgaW5zdGFsbGVkLiA="); ?>
   

2. clone or download this repository

3. copy the src directory to your web server.

4. rename config.sample.php to config.php and apply the imap settings. Move config.php to a safe location outside the public_html.

5. open backend.php and set the new path to config.php.

Build it yourself

The src directory contains all required files. If you want to update the php dependencies, you can update them yourself. You must have composer installed. See also build.sh.

Install php dependecies:

composer install

TODO

1. setup a link redirection provider (to keep the existence of your installation secret)
2. provide error message if config.php is missing or in a public folder.

Credit

This could not be possible without...

• http://angularjs.org/
• https://github.com/barbushin/php-imap
• https://github.com/gregjacobs/Autolinker.js/
• http://chancejs.com/
• https://github.com/TomFrost/node-phonetic