MailHog/docs/JIM.md

Introduction to Jim

Jim is the MailHog Chaos Monkey, inspired by Netflix.

You can invite Jim to the party using the invite-jim flag:

MailHog -invite-jim

With Jim around, things aren't going to work how you expect.

What can Jim do?

• Reject connections
• Rate limit connections
• Reject authentication
• Reject senders
• Reject recipients

It does this randomly, but within defined parameters.

You can control these using the following command line flags:

Flag	Default	Description
-invite-jim	false	Set to true to invite Jim
-jim-disconnect	0.005	Chance of randomly disconnecting a session
-jim-accept	0.99	Chance of accepting an incoming connection
-jim-linkspeed-affect	0.1	Chance of applying a rate limit
-jim-linkspeed-min	1024	Minimum link speed (in bytes per second)
-jim-linkspeed-max	10240	Maximum link speed (in bytes per second)
-jim-reject-sender	0.05	Chance of rejecting a MAIL FROM command
-jim-reject-recipient	0.05	Chance of rejecting a RCPT TO command
-jim-reject-auth	0.05	Chance of rejecting an AUTH command

If you enable Jim, you enable all parts. To disable individual parts, set the chance of it happening to 0, e.g. to disable connection rate limiting:

MailHog -invite-jim -jim-linkspeed-affect=0

Examples

Always rate limit to 1 byte per second:

MailHog -invite-jim -jim-linkspeed-affect=1 -jim-linkspeed-max=1 -jim-linkspeed-min=1

Disconnect clients after approximately 5 commands:

MailHog -invite-jim -jim-disconnect=0.2

Simulate a mobile connection (at 10-100kbps) for 10% of clients:

MailHog -invite-jim -jim-linkspeed-affect=0.1 -jim-linkspeed-min=1250 -jim-linkspeed-max=12500