https://github.com/zvecr/jmeter-smtp-server-plugin

SMTP server plugin for JMeter
https://github.com/zvecr/jmeter-smtp-server-plugin

jmeter jmeter-plugin

Last synced: 5 months ago
JSON representation

SMTP server plugin for JMeter

• Host: GitHub
• URL: https://github.com/zvecr/jmeter-smtp-server-plugin
• Owner: zvecr
• License: apache-2.0
• Created: 2019-03-04T13:35:22.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-07-26T06:20:56.000Z (almost 5 years ago)
• Last Synced: 2025-04-06T05:33:23.334Z (about 1 year ago)
• Topics: jmeter, jmeter-plugin
• Language: Java
• Homepage:
• Size: 153 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# jmeter-smtp-server-plugin

> SMTP server plugin for JMeter.

[![Build Status](https://travis-ci.org/zvecr/jmeter-smtp-server-plugin.svg?branch=master)](https://travis-ci.org/zvecr/jmeter-smtp-server-plugin)

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/2e2f1feaaa5a446580dec6ef3c81e040)](https://www.codacy.com/app/zvecr/jmeter-smtp-server-plugin?utm_source=github.com&utm_medium=referral&utm_content=zvecr/jmeter-smtp-server-plugin&utm_campaign=Badge_Grade)

[![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=zvecr/jmeter-smtp-server-plugin)](https://dependabot.com)

Self contained, pure java SMTP server hosted directly within JMeter. Aligned with the default `SMTP sampler`, the plugin provides support for various configuration including SMTP auth and TLS.

Removes the requirement of a POP3 or IMPS intermediate server when load testing SMTP receiving.

Ideal for load testing SMTP MITM proxies, the plugin allows for the following setup:

```text

+---------+      +---------+      +---------+

|         |      |         |      |         | 

| JMeter  |      |  SMTP   |      | JMeter  |

|  SMTP   |----->|  Proxy  |----->|  SMTP   |

| sampler |      |         |      | server  |

|         |      |         |      |         |

+---------+      +---------+      +---------+

```

**Note:** This plugin currently targets **JMeter 5.1** onwards.

## Example Usage

![SMTP server example](./docs/example.png)

See [examples](./examples/) folder for .jmx examples

## Installation

For an automatic Maven based solution, see examples folder on how to utilise `jmeter-maven-plugin`.

### Manual Installation

1. Download JMeter >= 5.1

2. Copy jar to plugin folder

## Development Setup

For a quick-start, the provided `Vagrantfile` can provision an environment easily without major changes to your primary operating system.

To build the virtual environment:

```sh

vagrant up

vagrant ssh

```

### Manual Development Setup

Dependencies required:

- Java 1.8

- Maven >= 3.5.0