self-hosted disposable email service (php) using catch-all and imap

disposable-email email-client imap imap-client php temporary-email trashmail

Find a file

Aravindo Wingeier 8590e36394 fix #71 find config.php automatically in current and parent directori… (#74 ) * fix #71 find config.php automatically. in current and parent directories. Show error message if not found.		2018-12-25 22:45:10 -03:00
src	fix #71 find config.php automatically in current and parent directori… (#74 )	2018-12-25 22:45:10 -03:00
.gitignore	simpler version without much js, just vanilla pure simple php (with some libs)	2018-01-09 00:23:36 +01:00
app.json	Updates for Heroku (#68 )	2018-09-20 13:44:41 -05:00
browserstack.png	Link to browserstack	2017-10-12 12:02:34 +02:00
CHANGELOG.md	fix #71 find config.php automatically in current and parent directori… (#74 )	2018-12-25 22:45:10 -03:00
composer.json	Updates for Heroku (#68 )	2018-09-20 13:44:41 -05:00
composer.lock	Updates for Heroku (#68 )	2018-09-20 13:44:41 -05:00
CONTRIBUTING.md	License: GPL-3.0	2017-04-15 21:10:22 +02:00
LICENSE.txt	License: GPL-3.0	2017-04-15 21:10:22 +02:00
README.md	new screenshot	2018-06-24 19:46:53 +02:00
screenshot_example.png	new screenshot	2018-06-24 19:46:53 +02:00

README.md

disposable-mailbox

A self-hosted disposable mailbox service (aka trash mail) ☁️ ✉️

Demo: BhadooMail

Features

Anonymous usage, generate random email addresses.
New Mail notification. Download and delete your emails.
Display emails as text or html with sanitization filter.
Display emails based on one catch-all imap mailbox.
Only requires PHP >=7.2 and imap extension

Usage

Requirements

webserver with php >=7.2
php imap extension
IMAP account and a domain with catch-all configuration. (all emails go to one mailbox).

Before you start ❗

Subscribe to to be notified about issues and bugfixes.
This is Beta software, there are still unsolved problems. Contributions are welcome! ❤️
License: GPL-3.0. You can modify this application and run it anywhere, charge money and show advertisement. Any forks or repacked distribution must follow the GPL-3.0 license.
A link to https://github.com/synox/disposable-mailbox in the footer is appreciated.

Installation

Disposable-mailbox can be installed by copying the src directory to a webserver.

assure the imap extension is installed. The following command should not print any errors:
```
 <?php print imap_base64("SU1BUCBleHRlbnNpb24gc2VlbXMgdG8gYmUgaW5zdGFsbGVkLiA="); ?>
```
download a release or clone this repository
copy the files in the src directory to your web server (not the whole repo!).
rename config.sample.php to config.php and apply the imap settings. Move config.php to a safe location outside the public_html.
edit index.php and json-api.php: set the new path to config.php.
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 update

Credit 👍

This could not be possible without...

Supported by BrowserStack, which allows us to test projects online with any browser as a service. :-)