mirror of
https://gitlab.com/ric_harvey/MailHog.git
synced 2024-11-23 14:24:03 +00:00
1.8 KiB
1.8 KiB
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