uilicious/inboxkitten repository overview

⁠Open-Source Disposable Email - Served by Serverless Kittens

Inboxkitten⁠ is an open-source disposable email service that you can freely deploy adopt on your own!

Visit our site⁠ to give a spin, or ...

⁠Docker Deployment Guide

Its one simple line - to use our prebuilt docker container.

Note you will need to setup your mailgun account first⁠

# PS: you should modify this for your use case
docker run \
	-e MAILGUN_EMAIL_DOMAIN="<email-domain>" \
	-e MAILGUN_API_KEY="<api-key>" \
	-e WEBSITE_DOMAIN="localhost:8000" \
	-p 8000:8000 \
	uilicious/inboxkitten

And head over to port 8000 - for your inboxkitten

⁠Other Deployment Options

• Serverless deployment guide (for cloudflare/firebase)⁠
• localhost/custom deployment/configuration guide⁠

⁠Support us on product hunt 🚀

• https://www.producthunt.com/posts/inboxkitten⁠

⁠Somewhat related blog / articles

• The Stack : Making a free open-source disposable email service prototype (inboxkitten.com) in 14 hours⁠
• What I have learnt from a 14 hours project⁠
• Development timeline⁠

⁠Other References

• Coding Guide⁠

⁠Looking for sponsor

Note: Due to this project rather heavy traffic usage, a good half sadly spam/bot related, we are looking for a hosting sponsor / sponsor to subsidise running cost

⁠How to Setup Mailgun - and get your free API key

⁠Mailgun

To sign up for a Mailgun account, go to the signup⁠ page.

⁠Custom Domain

	1. Click on `Add New Domain` button under your Domains panel. 
	2. Follow the steps accordingly

⁠Routes Configuration

After setting up your domain, in order for you to receive email, you have to configure the routes. Routes⁠ act as rules that will filter through all the incoming mails and execute actions on matched conditions.

In your Routes panel, simply click on Create Route button and follow the steps accordingly.

⁠Mailgun API Key

You can locate your Mailgun API key by clicking on the domain that you are managing. In it you can see your API key.

Or you can go to the security settings and locate the API key there.