Origami SMTP is a fake SMTP server with SSL (STARTTLS) support. The reason it was developed was so that developers could test their applications that require a secure SMTP server without having to change more than just a couple settings.
This project is the runnable jar file but you can download a easier to use application (also know as Origami SMTP) from the official website
How to Help the Project
The best way you can help support this project is by suggesting features via the issue tracker and posting a bounty for it. There will be a link to post a bounty after the issue is submitted.
If you need help the best way to obtain it is by visiting https://pessetto.com/submit-ticket. Select department of Open Source and the Product of Origami SMTP. Support has two levels you can choose from; free and paid. To upgrade support just wait for the response offering paid support and you will be provided an invoice for your request which can be paid online with a credit card via the billing portal.
Paid support will be invoiced based on estimated work required. Minimum of $10.00 (USD) charge applies to paid request.
- 1 week minimum wait time
- Major issues may take significant time
- Issue will be handled with no wait time
- Major issues can be solved in a timely manner
- Helps keep the project alive
This server requires:
Starting the Server
To start the server run the following from the terminal or command line.
java -jar origami.jar 2525
You may replace 2525 with the port you would like to use.
Working with STARTLS
Since this service requires some custom configuration, you will have to load the Origami CA Certificate into your Trusted Root Store. If you are unsure how to do this on Windows follow this guide. You will have to do this on other operating systems too but at this time we have no guides provided.
Next make sure your SMTP settings set the host to localhost and not the IP address 127.0.0.1 or the validation may fail, notably in C#.
You may have to download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8. This extension may be restricted in some countries and may have export controls enforced by the United State Government. Since we do not have the funds for legal council this file must be downloaded from the link provided. Follow the instructions in README.txt to install.
To use Swaks to debug you will need Perl installed. To do this on Windows we suggest the use of ActivePerl as we could not get it to work with Strawberry Perl. After that is installed you can use the following command to help with debugging.
swaks.pl -t firstname.lastname@example.org -f email@example.com -s localhost -p 2525 -tls --tls-verify --tls-ca-path /path/to/origami/ca.crt
To use OpenSSL s_client to try and debug use the following command
openssl s_client -connect localhost:2525 -starttls smtp
Previously 127.0.0.1 was used in place of localhost so it may validate correctly now but has not been tested.
- When working in Eclipse it is recommended to set the VM arguments to -Djavax.net.debug=ssl,handshake
- You can use openssl to help you debug
- You can use Swaks to help debug
Contributing is simple just fork this on GitHub and then send a pull request.