/forsaken-mail

a self-hosted disposable mail service

Primary LanguageJavaScriptGNU General Public License v2.0GPL-2.0

Forsaken-Mail

A self-hosted disposable mail service.

Online Demo

Installation

Setting up your DNS correctly

In order to receive emails, your smtp server address should be made available somewhere. Two records should be added to your DNS records. Let us pretend that we want to receive emails at *@subdomain.domain.com:

  • First an MX record: subdomain.domain.com MX 10 mxsubdomain.domain.com. This means that the mail server for addresses like *@subdomain.domain.com will be mxsubdomain.domain.com.
  • Then an A record: mxsubdomain.domain.com A the.ip.address.of.your.mailin.server. This tells at which ip address the mail server can be found.

You can fire up Mailin (see next section) and use an smtp server tester to verify that everything is correct.

Setup config.json

Copy config-default.json to config.json and put all your domains into variable domains in config.json.

Let's Go

general way:

npm install && npm start

if you want to run this inside a docker container

docker build -t denghongcai/forsaken-mail .
docker run --name forsaken-mail -d -p 25:25 -p 3000:3000 denghongcai/forsaken-mail

Open your browser and type in

http://localhost:3000

Enjoy!