How to use Papercut-SMTP? [docs]

[Carsak]

Does this program have documentation?
How to use this program, how to intercept mails?

[Jaben]

When you start Papercut, it begins to listen for incoming emails. How are you sending?

[murermader]

I don't understand how to use the app either. Just so I don't get anything wrong: This is a client that receives emails, so I don't have to send them to myself / someone I know. Is that correct?

If so, how to I send an email to this application? What should I put in the "To" field?

[leigh-pointer]

@murermader
In short.
You will need to setup your email application/component to handshake with paperclip on 127.0.0.1 port 25 (default) then your email application/component will send any email to paperclip and you will see them in the paperclip inbox

[rmpasswd]

Hello, for complete newbies to email testing like me:
i had to start papercut.exe as well as papercutservice.exe which opened in a command prompt; only then papercut started receiving emails.
It must be obvious to everyone maybe that's why it's not mentioned in the readme.

[Jaben]

@rmpasswd The papercut service NOT required. You can just use Papercut.exe.

[ZekDtonik]

Hi, its very simple, you will install the application on your system, e after installed, open the program and click in the logs button, see the image below

if you can see the message "Papercut Backend Service is running." you local SMTP is working for and ready to work...

Now, you need to check the port that the program is running on... commonly is 25, watching any ip (you can change that in options), see the second image below

and that it!

Now, on your server config on DEV Env (obviously), input any username and password and any ip (or the ip that you setup on options before), the only thing that you need to pay attention is the port number, need to be the same set on papercut... now, when u send a message on local machine for test the papercut will capture.

Good Luck :)

[Kissaki]

I don't understand how to use the app either. Just so I don't get anything wrong: This is a client that receives emails, so I don't have to send them to myself / someone I know. Is that correct?

If so, how to I send an email to this application? What should I put in the "To" field?

Because it hasn't been answered explicitly; No, it's not a client and you don't send to it via the To email address.

Papercut takes the place of an email server. You can send emails to it via SMTP. The To field is irrelevant. Papercut accepts any To field.

[Kissaki]

What kind of documentation would be desired for resolving this ticket?

Markdown files in a /docs/ folder?

[Jaben]

Papercut SMTP now has a proper documentation site: https://www.papercut-smtp.com/

For the questions raised in this thread specifically:

• How It Works — explains what Papercut is (a fake SMTP server that takes the place of a real one), why the To field doesn't matter, and why no account or credentials are needed
• Getting Started — install, first run, and sending a first test email
• Send Email from Your App — copy-paste configuration for .NET, Node.js, Python/Django, PHP/Laravel, Java/Spring, and Ruby/Rails
• Troubleshooting — including "I don't see any emails" and "do I need the service?" (no, you don't)

The docs live in the repo under /docs (as @Kissaki suggested) — corrections and improvements via PR are very welcome. Thanks to everyone in this thread for pushing this along!