self-hosted disposable email service

Goals:

• easy to use: random or custom name, auto refresh
• easy to host: just php5 with imap extension, catch-all mailbox
• easy to install: copy-paste and imap config
• minimal code base: minimal features and complexity

You have to know

• Use and you will be be notified about issues and bugfixes.
• This is WORK IN PROGRESS (WIP) software, do not use it in production yet! There are still unsolved problems. Contributions are welcome!
• Licence:
  disposable-mailbox by github:synox is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Requirements

• apache 2 webserver with php >=5.3.0 (let me know how it works on nginx!)
• php imap extension
• IMAP account and a domain with catch-all configuration. (all mails go to one mailbox).

Installation

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

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

2. download a release or clone this repository

3. copy the files in the src directory to your web server (not the whole repo!).

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. edit backend.php and set the new path to config.php.

6. open it in your browser, check your php error log for messages.

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.

Install php dependecies:

composer install

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/