mirror of
https://gitlab.com/ric_harvey/MailHog.git
synced 2024-11-27 08:14:04 +00:00
Add readme
This commit is contained in:
parent
9868f1f7f6
commit
c926e81a4d
1 changed files with 46 additions and 0 deletions
46
README.md
Normal file
46
README.md
Normal file
|
@ -0,0 +1,46 @@
|
|||
Go-MailHog
|
||||
=========
|
||||
|
||||
Inspired by [MailCatcher](http://mailcatcher.me/), easier to install.
|
||||
|
||||
Go-MailHog is a rewritten version of [MailHog](https://github.com/ian-kent/MailHog), which was born out of [M3MTA](https://github.com/ian-kent/M3MTA).
|
||||
|
||||
Go was chosen for portability - MailHog runs without installation on multiple platforms.
|
||||
|
||||
### Requirements
|
||||
|
||||
* None!
|
||||
* Well, you need MongoDB installed somewhere
|
||||
|
||||
### Getting started
|
||||
|
||||
* Download the latest release of Go-MailHog for your platform
|
||||
* Start MailHog
|
||||
|
||||
By default, the SMTP server will start on port 1025, and the HTTP
|
||||
server will start on port 8025.
|
||||
|
||||
### Configuration
|
||||
|
||||
| Parameter | Default | Description
|
||||
| ------------- | --------------- | -----------
|
||||
| -hostname | mailhog.example | Hostname to use for EHLO/HELO and message IDs
|
||||
| -httpbindaddr | 0.0.0.0:8025 | Interface and port for HTTP server to bind to
|
||||
| -mongocoll | messages | MongoDB collection name for message storage
|
||||
| -mongodb | mailhog | MongoDB database name for message storage
|
||||
| -mongouri | 127.0.0.1:27017 | MongoDB host and port
|
||||
| -smtpbindaddr | 0.0.0.0:1025 | Interface and port for SMTP server to bind to
|
||||
|
||||
### Contributing
|
||||
|
||||
Clone this repository to ```$GOPATH/src/github.com/ian-kent/MailHog``` and type ```go install```.
|
||||
|
||||
Run tests using ```go test```. You'll need a copy of MailHog running for tests to pass.
|
||||
|
||||
If you make any changes, run ```go fmt``` before submitting a pull request.
|
||||
|
||||
### Licence
|
||||
|
||||
Copyright © 2014, Ian Kent (http://www.iankent.eu).
|
||||
|
||||
Released under MIT license, see [LICENSE](license) for details.
|
Loading…
Reference in a new issue