VWH Email

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

Website • API Docs

---

Dockerized Installation (Coming Soon)

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

Manual Installation

Prerequisites

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

---

Step 1: DNS Configuration (Cloudflare)

1. Log in to your Cloudflare account

2. Select your domain (vwh.sh)

   Note: In all the following steps, replace vwh.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

---

Step 2: VPS Setup

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

---

Step 3: Install and Configure Postfix

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.sh
   mydestination = $myhostname, vwh.sh, localhost.$mydomain, localhost
   inet_interfaces = all
   mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128
   smtpd_recipient_restrictions = permit_mynetworks, reject_unauth_destination
   virtual_alias_domains = vwh.sh
   virtual_alias_maps = regexp:/etc/postfix/virtual_regexp
   

4. Create and edit the virtual_regexp file:

   sudo nano /etc/postfix/virtual_regexp

   Add this line:

   /.+@vwh\.sh/ [email protected]
   

---

5. Restart Postfix:

   sudo systemctl restart postfix

---

Step 4: Configure Postfix to Forward Emails to Webhook

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/bash
   sed '/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 the Secret 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

---

Step 5: Install and Configure Website

1. Clone VWH Email repository:

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

2. Install dependencies:

   npm install --force

3. Configure environment variables:

   • Add your SECRET to the environment configuration

   SECRET="12398"

4. Start development server:

   npm run dev

---

Contributing

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

License

Under the MIT License. See License for more information.