Intro

Mailpile packages are currently available for recent Debian-derived distributions, including Ubuntu. The packages are architecture-independent and should be compatible with most desktops, servers and embedded hardware (such as the Raspberry Pi). They have been tested on Debian 8, Debian 9 and Ubuntu 16.04 LTS.

You can download the package files directly or use our repository. Using the repository is recommended, so you don't miss important security updates or bugfixes.

We hope to add support for other package formats in the near future. In the meantime, you can use the source, Luke!

Apache Integration: "Multipile"

In addition to the core mailpile package, we currently offer an optional package named mailpile-apache2.

This package will add a simple "launch and proxy" configuration to the Apache web server, which will allow any user on the machine to access their Mailpile over the web at https://your.example.com/mailpile/. Some administration is required; please consult the documentation.

Be careful! We do not recommend exposing Mailpile to the public web without first enabling HTTPS encryption! Lets encrypt helps make that easy.

Nightly vs. Release

Two sets of packages are provided, nightly packages which are automatically built from the Github master branch and release packages which are updated less frequently and should be more stable.

The release packages are recommended, unless you are eager to help debug and test our latest work... which would be most appreciated!

Version Numbers

Note that the release candidate packages have version numbers in the 0.99.* range. This is done so we can release a 1.0.0 package later on and be sure it will be considered "newer" than the release candidates.

Debian Repository

Using one of our Debian repositories is the recommended way to install Mailpile on Linux, since it makes updates and upgrades quick and easy.

Adding the Repository

To use our repositories you will first need to add the packaging signing key using the `apt-key` tool and then add the repository itself to your list of APT sources. Commands for accomplishing this are listed below (for completeness we include commands to install curl and the apt tools - you may already have these installed).

$ sudo apt-get update && sudo apt-get install curl apt-transport-https gnupg
...

$ curl -s https://packages.mailpile.is/deb/key.asc |sudo apt-key add -
...

$ echo "deb https://packages.mailpile.is/deb release main" |sudo tee /etc/apt/sources.list.d/000-mailpile.list
...

Note that if you wish to use our nightly builds instead of the release packages, you need to replace the word release with nightly in the APT sources entry.

Installing Mailpile

You can now install Mailpile (with or without the Apache integration) with a single command:

## Mailpile
$ sudo apt-get update && sudo apt-get install mailpile
...
    
## Multipile
$ sudo apt-get update && sudo apt-get install mailpile-apache2
...

Now you should be able to run mailpile on the command line and join the fun! If you have installed the Apache integration, you can access https://your.example.com/mailpile/ and log on that way.

Uninstalling

$ sudo apt-get remove mailpile mailpile-apache2
...

$ sudo rm /etc/apt/sources.list.d/000-mailpile.list && sudo apt-get update
...

You may also want to consult our Wiki for details about how to remove Mailpile's data files.

Debian Packages

Verifying Package Integrity

All packages should be signed with our packaging PGP key.

To verify the signature, add our key to your keychain and then use the dpkg-sig tool to check the packages, like so:

$ apt-get install curl dpkg-sig
...

$ curl -s https://packages.mailpile.is/deb/key.asc |gpg --import -
...

$ dpkg-sig --verify mailpile*.deb
...

Installation

Installation is straightforward; use the dpkg tool to install the downloaded packages themselves, and then use apt-get to install any missing dependencies.

$ sudo dpkg -i mailpile*.deb
...

$ sudo apt-get install -f
...

Now you should be able to run mailpile on the command line and join the fun! If you have installed the Apache integration, you can access https://your.example.com/mailpile/ and log on that way.

Note: If apt-get complains about missing dependencies, check whether matching packages are provided above.

Uninstalling

$ sudo apt-get remove mailpile mailpile-apache2

You may also want to consult our Wiki for details about how to remove Mailpile's data files.