You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
James Hillyerd c64e7a6a6c
Revert "Add support for AUTH, closes #62" (#206)
1 month ago
.github/workflows Migrate release process from travis to github (#175) 9 months ago
cmd Add configurable base path for reverse proxy use (#169) 10 months ago
doc Add configurable base path for reverse proxy use (#169) 10 months ago
etc Add configurable base path for reverse proxy use (#169) 10 months ago
pkg Revert "Add support for AUTH, closes #62" (#206) 1 month ago
ui ui: Replace Mailbox Session use with ServeUrl (#185) 8 months ago
.dockerignore Update backend and docker dependencies (#173) 9 months ago
.gitattributes Line ending normalization 7 years ago
.gitignore Set base path in index.html (#172) 9 months ago
.goreleaser.yml release: Modernize goreleaser config 1 year ago
.travis.yml Migrate release process from travis to github (#175) 9 months ago
CHANGELOG.md Update changelog for 3.0.0-rc1 8 months ago
CONTRIBUTING.md Add tl;dr to CONTRIBUTING.md 3 years ago
Dockerfile Update backend and docker dependencies (#173) 9 months ago
LICENSE Add some text to readme and the MIT license. 8 years ago
Makefile docker: Default to JSON log output for #90 3 years ago
README.md Readme updates (#183) 8 months ago
go.mod Update deps (#184) 8 months ago
go.sum Update deps (#184) 8 months ago
shell.nix nix: add elm lang server, for nixos newer than 19.09 1 year ago

README.md

Inbucket

Build Status Docker Image

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

A Go client for the REST API is available in github.com/inbucket/inbucket/pkg/rest/client - Go API docs

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.

Docker

Inbucket has automated Docker Image builds via Docker Hub. The stable tag tracks our master branch (releases), latest tracks our unstable development branch.

Building from Source

You will need functioning Go and Node.js installations for this to work.

git clone https://github.com/inbucket/inbucket.git
cd inbucket/ui
npm ci
npm run build
cd ..
go build ./cmd/inbucket

For more information on building and development flows, check out the Development Quickstart page of our wiki.

Configure and Launch

Inbucket reads its configuration from environment variables, but comes with reasonable defaults built-in. It should work on most Unix and OS X machines as is. Launch the daemon:

./inbucket

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

See doc/config.md for more information on configuring Inbucket, but you will likely find the Configurator tool the easiest way to generate a configuration.

About

Inbucket is written in Go and Elm.

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