Repository files navigation

VWH Email

Open-source temporary email service that provides quick, anonymous email solutions.

Website• API Docs

Status: Under Development

• Complete Docker containerization is in progress
• Will include Postfix mail server
• One-click deployment
• Simplified configuration
• Expected features:
  • Pre-configured Postfix
  • Integrated webhook
  • Easy environment setup

• Domain: vwh.sh
• DNS Provider: Cloudflare
• Server: Ubuntu VPS
• Mail Server Software: Postfix

1. Log in to your Cloudflare account

2. Select your domain (vwh.sh)

   Note: In all the following steps, replacevwh.sh with your domain name.

3. Go to the DNS settings

4. Add the following records:

   • MX record:
     • Name:@
     • Value:mail.vwh.sh
     • Priority: 10
   • A record:
     • Name:mail
     • Value:[Your VPS IP address]
   • TXT record (for SPF):
     • Name:@
     • Value:v=spf1 mx ~all

1. SSH into your Ubuntu VPS
2. Update the system:

   sudo apt update&& sudo apt upgrade -y

3. Set the hostname:

   sudo hostnamectl set-hostname mail.vwh.sh

4. Update/etc/hosts:

   sudo nano /etc/hosts

   Add:[Your VPS IP] mail.vwh.sh vwh.sh

1. Install Postfix:

   sudo apt install postfix -y

2. During installation, choose "Internet Site" and enter "vwh.sh" as the system mail name
3. Edit the main Postfix configuration:

   sudo nano /etc/postfix/main.cf

   Add or modify these lines:

   myhostname = mail.vwh.shmydestination = $myhostname, vwh.sh, localhost.$mydomain, localhostinet_interfaces = allmynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128smtpd_recipient_restrictions = permit_mynetworks, reject_unauth_destinationvirtual_alias_domains = vwh.shvirtual_alias_maps = regexp:/etc/postfix/virtual_regexp

4. Create and edit thevirtual_regexp file:

   sudo nano /etc/postfix/virtual_regexp

   Add this line:

   /.+@vwh\.sh/ catchall@vwh.sh

5. Restart Postfix:

   sudo systemctl restart postfix

1. Install procmail:

   sudo apt install procmail -y

2. Create a script to forward emails:

   sudo nano /usr/local/bin/forward-to-webhook.sh

   Add the following content:

   #!/bin/bashsed'/Content-Disposition: attachment/,/^\s*$/d; /Content-Disposition: inline/,/^\s*$/d'| \curl -X POST -H"Content-Type: text/plain" -H"Secret: 12398" --data-binary @- http://localhost:9169/webhook

   Note: Update theSecret to match your website/webhook environment variable

   Note: It will forward the email to the webhook URL by default (http://localhost:9169/webhook). If you want to forward it to a different URL, you can change the URL in the script.

3. Make the script executable:

   sudo chmod +x /usr/local/bin/forward-to-webhook.sh

4. Edit the Postfix aliases file:

   sudo nano /etc/aliases

   Add this line:

   catchall: "|/usr/local/bin/forward-to-webhook.sh"

5. Update the aliases database:

   sudo newaliases

6. Restart Postfix:

   sudo systemctl restart postfix

1. Clone VWH Email repository:

   git clone https://github.com/vwh/vwh-emailcd vwh-email

2. Install dependencies:

   npm install --force

3. Configure environment variables:

   • Add yourSECRET to the environment configuration

   SECRET="12398"

4. Start development server:

   npm run dev

Contributions are welcome! Feel free to open a pull request with your improvements or fixes.

Under the MIT License. SeeLicense for more information.