Pepsi Manual

Pepsi is a mail server for individuals and for small and medium-sized organisations that want to run their own e-mail instead of handing it to a large provider. It receives your mail from the Internet and sends your mail out, keeping it secure both inside your organisation and on its way to anyone else.

Secure e-mail without the hassle. Pepsi signs, encrypts and decrypts mail with the two established standards, OpenPGP and S/MIME, and finds and manages the keys that this requires. For every message, you can see plainly who really sent it. Your users do not need any special software, and a correspondent who has no encryption of their own can still read your protected mail on a secure web page.

Less spam. Like other mail servers, Pepsi checks where each message really comes from. It can also ask an unknown sender to confirm that they are human, or to attach a tiny payment with GNU Taler, before their mail reaches you. For your correspondents this costs almost nothing; for someone who sends millions of messages, it adds up to real money.

Easy to set up. You answer a few questions, and the setup program does the rest: it generates all the keys, obtains the certificates and tells you exactly which records to publish in the DNS. Afterwards, it checks that you published them correctly. These records matter, because other providers use them to decide whether to accept your mail. Debian and Ubuntu packages are available from deb.taler.net (Installing Pepsi).

Fits into your system. Pepsi delivers incoming mail to your users’ mailboxes, to a separate delivery program, or to another mail server. It does not let mail programs read mailboxes over IMAP; for that, most sites add Dovecot.

Built for security. Pepsi is written in a memory-safe language and is split into small programs, each of which has only the rights that it needs. The Threat model and Security model chapters explain in detail what Pepsi protects against and how.

Free Software. Pepsi is free software under the GNU Affero General Public License: you may run it for any purpose, study how it works and change it, and share it with others, with or without your changes. Nobody can take these freedoms away from you, and nobody can lock you in. The source code is public at git://git.taler.net/pepsi.git.

Start with Introduction, which explains what Pepsi is, lists its features, compares it with the established mail servers and explains how the rest of this manual is organised. Getting started on a cheap VPS walks you from the DNS setup to the first e-mail that you receive, and The Wizard shows the pipelines that pepsi-setup --wizard builds and what each of its questions decides.

Contents

Indices