✍️
Emaildelivery.com Documentation
EmailDelivery.com
  • FAQ
    • ✍️FAQ
    • 🎬Explainer Video
    • 🤳Why go self-hosted?
    • 🌋Recommended VPS
    • Ⓜ️Velocity MTA FAQ
    • 🌴Amazon SES production access
    • 👋From the founder
  • Features List
    • 🖌️ESP Features
      • 🟢Pabbly Connect
      • 🪝Event Webhooks
    • 🎨Delivery Features
  • install
    • 🤓Racknerd Installation
    • 👩‍💻Generic VPS Installation
    • 🌊Installation video for Digital Ocean droplets
    • 🧠Advanced Installation
  • Common installation issues
    • 🙅Don't use sudo
    • ✋Bind: address already in use
    • 👬Resolving port conflicts with a second IP
    • 😑Hostinger is your registrar
    • 💪Use the ARM build for AArch64/ARM64 CPUs
    • ⭕Oracle Cloud / Amazon Lightsail: "bind cannot assign requested address 8025"
    • 🔗Links in email messages are doing something unexpected
  • Post Installation
    • 🔺Upgrade instructions
    • 💾Backup and Restore
    • 🐳Docker Information
    • 🪵Logging
    • 🚚Moving to a new server
    • 📇Changing the installation domain
    • 🎟️Reset lost administrator password
    • ♻️How to reinstall
    • 🔑Add our SSH keys for support
  • options for adding https
    • 🔐Free Native SSL via Let's Encrypt
    • 🔐Adding HTTPS to email message links
    • 🔐Cloudflare as SSL proxy
    • 📮Transactional SMTP Relay requirements for Cloudflare
    • 🚧Troubleshooting common SSL issues
    • 🔏Native SSL via ZeroSSL
  • Introduction
    • 👥Backend, Frontend, Customers, Users
    • 🧑‍🏫What you can do in the emaildelivery.com backend
    • 👩‍💻Getting ready to send
    • 🔗Understanding the 'White Label Tracking Link'
    • ⚡Connect SMTP Relay
    • 🔌Connect Mailgun API
    • 🔌Connect Sparkpost API
    • 🔌Connect Amazon SES API
    • 📮Postal Routes
    • 📬Send a test message
  • Common email setup issues
    • 🎭"Unconfigured sending domain" during test message
    • 😶Campaign stats are blank
  • Solutions and guides
    • 🌴Getting approved for Amazon SES production access
    • 🔍Google Postmaster Tools
  • Backend Administration
    • ™️Change your logo and favicon
    • 🖍️Change your colors and theme using Custom CSS
    • 🔓Password reset configuration
    • 🖥️Creating Customer Accounts
    • 💻Creating User accounts
    • 🖼️Create default email templates
    • 📋Create default subscriber form templates
    • 🧹Purging mail queues
    • 👥Logging in to the email marketing frontend
    • ⚙️Frontend Settings
      • Profile tab
      • Broadcast alert thresholds
      • Default send limits
      • Header template
    • 📰Customer broadcast report
    • 🆕Changelog
  • Integrations
    • 🟢Pabbly Connect
    • 🟥Zapier
    • 🪝Event webhooks
    • 🅰️API
    • 🖼️Integrating Pixabay into your email campaigns
    • 🏋️WordPress
  • Advanced postal route configuration
    • 🤹‍♂️Contact list domain routing
    • ⚖️Load balancing
  • Control your sending speed
    • 🚦Domain throttles
  • Transactional
    • 🧾Transactional API
    • 📮Transactional SMTP Relay
    • ✅Transactional SMTP Relay: steps to start sending
    • 📁Transactional templates
    • 🏷️Transactional tags
    • 🧀Use SWAKS for testing and troubleshooting
  • What you need to know before you install Velocity MTA
    • 🚫The ESP Platform IP can't be used with the MTA
    • ☝️PTR Records and Reverse DNS
    • 🧬Sending Domain and PTR must match
    • 🔍Google Postmaster Tools
    • 🔗MTA link domain points to the sending IP, not the ESP IP
    • 🤝How to use Velocity MTA as an SMTP Relay
  • 🚀Velocity MTA BASICS
    • 👨‍💻Getting ready to send
    • 🪵Velocity.log is vital to your success
    • 💽Installing Velocity MTA
    • ⚠️Common installation issues
    • ⭕Oracle Cloud and Amazon Lightsail issues
      • 🧑‍🏫What you can do with an MTA Delivery Policy
    • 🦾Adding a server in the backend UI
      • 🔌Server Connect MTA Tab
    • 🆔Configure DKIM
    • 🧙Creating an MTA Delivery Policy
      • Domains Page
      • Settings Page
      • Deferrals Page
      • Servers Page
      • Pushing MTA Policy Changes
    • 📮Create a Postal Route
    • 📬Sending your first test message
    • 🤖IP Warmup automation
    • 🥺Asking major mailbox providers for a reprieve
  • Velocity MTA Solutions
    • 🔐Adding HTTPS to Velocity MTA email message links
    • 👨‍🏫Adding a new dedicated IP to a customer account
    • 🌡️How to warm up a new IP
    • 🕊️Using Dovecot for IMAP
  • 📚Velocity MTA Continuing Education
    • 😡Complaint Feedback Loops
    • 📊IP Delivery Reports
    • 🚦Mail queue management
    • 📥Incoming email MX server
    • ⚔️Customizing delivery for large mailbox providers
    • 🐳Docker information
    • 🧀Troubleshooting with SWAKS
    • 📋Comprehensive CFL / FBL list
  • Troubleshooting MTA related errors in the email marketing interface
    • ⁉️HTTPConnectionPool Max retries exceeded with url: /settings
  • Troubleshooting common issues in the email marketing interface
    • ⁉️Campaign stats are blank
    • ⁉️Pabbly connection errors
    • ⁉️API connections are failing
    • ⁉️The API docs page is blank
    • ⁉️Form submission says Error
    • ⁉️Images are not displaying
  • What to know before using the email marketing platform
    • 📇Contact lists use a flexible architecture
    • 📋Properties are created dynamically
    • 🆔You can personalize on all properties and in URLs
    • 🚮Unsubscribes, complaints, and bounces are account-wide
    • 🎨Drag and drop, WYSIWYG, raw HTML, and reusing templates
    • 🚦You can throttle your sending for each postal route
  • Contact list management
    • ➕Create a contact list
    • ♻️Resubscribe after an unsubscribe
    • 👓List X-Ray
    • 🏷️Contact Tags Manager
    • ⬇️Export your contact list
    • 🚫Uploading a suppression list
    • ⚠️Large suppression files
    • ⛔Exclusion Lists
    • 🇪🇺GDPR Delete & Export
  • Segmenting
    • 🧑‍🏫What you can do with segments
    • ➕Create a segment
    • 🧱Designing your segment
    • 🏷️Tag contacts in a segment
    • ⬇️Export a Segment's Contacts
    • 🆎A/B test using segments
  • Broadcasts
    • 🧑‍🏫What you can do with broadcasts
    • ➕Create a Broadcast
    • ⚙️Broadcast Settings
    • ⌨️Choosing your email composer
    • 🗣️Augment your subject line with a preheader
    • 📬Adding your recipients
    • ⏲️Schedule your Broadcast
    • 🔂Resend to non-openers automation
    • 📰Broadcast Reporting
    • 👯‍♀️Duplicate a broadcast
    • 🏷️Tag contacts who Open your broadcast
    • 💫Resume an incomplete broadcast
    • ⬇️Export Broadcast Openers & Unsubscribes
    • 🛑Cancel a broadcast
    • 🔗Cancel a broadcast funnel trigger
    • 🔧Revise tagging and funnel triggers for sent broadcasts
  • Using the integrated beefree.io email composer
    • 🦶Editing the sticky footer
  • Using the legacy drag & drop email composer
    • ⌨️The Basics
    • 🛠️Component Section Toolbar
    • 🏛️Designing your email - Using Columns
    • 🦶Footer
    • 🐦Social Media Component
  • Funnels
    • 🧑‍🏫What you can do with funnels
    • ➕Create a funnel
    • 🪆Choosing your funnel type
    • 🆔From Name & From Email - editing
    • ⚡Activating your funnel
    • 🔗Trigger an email funnel from a broadcast
    • 🏷️Tag contacts who open your funnel messages
    • ⌨️Choosing your email composer
    • 🗣️Augment your subject line with a preheader
    • 🤖Design your automated email sequence
    • 🚫Contact Suppression and Exclusion
    • 🖇️Adding a funnel to an opt-in subscriber form
  • Subscriber opt-in forms
    • 🧑‍🏫What you can do with forms
    • ➕Create an opt-in form
    • 2️⃣2⃣ Sending to double opt-in contacts
    • 📋Choosing your form type: floating bars, lightboxes,inline naked embedded, slide outs
    • 🔙Exit intent and display rules
    • 📋Adding email and name input boxes to your form
    • Setting the size of your form
    • 📱Configuring how your form displays on mobile devices
    • 📲Configuring your mobile width
    • ✖️Add a close window X to your form
    • ⛔Adding a "No" button that closes your form
    • 🏷️Tag subscribers who opt-in to your form
    • 🙅‍♀️Adding "no thanks" text which closes your form
    • 🔣View your form conversion rate
    • 🔗Connect an existing form to your account
    • 🕸️Adding your form to your website
    • 🤖Add opt-in subscribers to an automated email sequence
  • Reply to ElMejor
  • Reply to ba9607f2e
  • Reply to ricardo108
  • Reply to dasGuteDaran
Powered by GitBook
On this page

Was this helpful?

  1. Transactional

Use SWAKS for testing and troubleshooting

PreviousTransactional tagsNextThe ESP Platform IP can't be used with the MTA

Last updated 1 year ago

Was this helpful?

SWAKS is a vital tool to learn for testing and troubleshooting your ESP platform.

When you use SWAKS for troubleshooting, you're reducing variables and confounders that may be caused by the software you're introducing into your email ecosystem.

Install SWAKS using one of the methods on their installation page:

Test to see if you can connect to a port on your ESP platform using the DNS hostname:

swaks --server transactional.fivetacofiesta.com --port 587 -q connect

A successful connection will look something like the following:

If connecting using the DNS hostname fails, try the IP address of your VPS instead:

swaks --server 1.2.3.4 --port 587 -q connect

*** Note: You must use the real IP address of your Linux VPS above, not "1.2.3.4", it's a placeholder.

SWAKS syntax basics

Type swaks --help to see some example use cases and documentation.

--from sender@my.domain.com   
--to recipient@domain.com  
--server esp.domain.com    
--port 587                 
--auth LOGIN               
--auth-user API Key        
--auth-password API Key    
--header "Subject: hello from SWAKS"
--body "This is a SWAKS demo" 

Use the real email address you want to send this message from here:

--from sender@my.domain.com

Use the real email address you want to send this message to here:

--to recipient@domain.com  

Your ESP platform DNS or IP:

--server esp.domain.com 

Your ESP platform listens for STMP Relay on Ports 587, 2525, and 8025:

--port 587 

Tell your ESP platform to use a username and password for authentication:

--auth LOGIN 

Use your user API Key for your username:

--auth-user S8PHFSJyyc7GuYbJ2SHFVq

*** Note: You must use your real user account API Key above, not "S8PHFSJyyc7GuYbJ2SHFVq", it's a placeholder.

Use your user API Key for your password:

--auth-password S8PHFSJyyc7GuYbJ2SHFVq

*** Note: You must use your real user account API Key above, not "S8PHFSJyyc7GuYbJ2SHFVq", it's a placeholder.

Putting it all together:

A successful message will look something like the following:

Using your ESP platform's custom SMTP headers with SWAKS:

Tag your message:

--header "X-Transactional-Tag: SWAKS"

Choose a postal route for this message:

--header "X-Transactional-Route: AjdytEc4dzfYhuk9nWCq6Y"

*** Note: You must use the real postal route ID above, not "AjdytEc4dzfYhuk9nWCq6Y", it's a placeholder.

Use a transactional template for this message instead of --body:

--header "X-Transactional-Template: MsmsEaZZDxYyBJyVXXwA2A"

*** Note: You must use the real transactional template ID above, not "MsmsEaZZDxYyBJyVXXwA2A", it's a placeholder.

ChatGPT is an expert SWAKS user.

Ask it how to do anything you need to test with SWAKS and it will know.

🧀
Swaks - Swiss Army Knife for SMTP
Logo