README

Inbucket

Build Status

Inbucket is an email testing service; it will accept messages for any email address and make them available via web, REST and POP3. Once compiled, Inbucket does not have any external dependencies (HTTP, SMTP, POP3 and storage are all built in).

Read more at the Inbucket Website

Screenshot

Development Status

Inbucket is currently production quality: it is being used for real work.

Please see the Change Log and Issues List for more details. If you'd like to contribute code to the project check out CONTRIBUTING.md.

Homebrew Tap

(currently broken, being tracked in issue #68)

Inbucket has an OS X Homebrew tap available as jhillyerd/inbucket, see the README.md there for installation instructions.

Building from Source

You will need a functioning Go installation for this to work.

Grab the Inbucket source code and compile the daemon:

go get -v github.com/jhillyerd/inbucket/cmd/inbucket

Edit etc/inbucket.conf and tailor to your environment. It should work on most Unix and OS X machines as is. Launch the daemon:

$GOPATH/bin/inbucket $GOPATH/src/github.com/jhillyerd/inbucket/etc/inbucket.conf

By default the SMTP server will be listening on localhost port 2500 and the web interface will be available at localhost:9000.

The Inbucket website has a more complete guide to installing from source

About

Inbucket is written in Google Go

Inbucket is open source software released under the MIT License. The latest version can be found at https://github.com/jhillyerd/inbucket

Expand ▾ Collapse ▴

Directories

Path Synopsis
cmd
client
Package main implements a command line client for the Inbucket REST API
Package main implements a command line client for the Inbucket REST API
inbucket
main is the inbucket daemon launcher
main is the inbucket daemon launcher
pkg
message
Package message contains message handling logic.
Package message contains message handling logic.
rest/client
Package client provides a basic REST client for Inbucket
Package client provides a basic REST client for Inbucket
server/web
Package web provides the plumbing for Inbucket's web GUI and RESTful API
Package web provides the plumbing for Inbucket's web GUI and RESTful API
storage
Package storage contains implementation independent datastore logic
Package storage contains implementation independent datastore logic
webui
Package webui powers Inbucket's web GUI
Package webui powers Inbucket's web GUI