Getting started on MacOS
-
Please download the OS X installer from our website.
-
Once downloaded, open the installer from your Downloads directory. When the Mailpile folder opens, drag the Mailpile.app application icon into your Applications directory.
-
Now, launch Mailpile by navigating to your Applications directory or selecting it in Launchpad.
-
You may see a Gatekeeper dialog box shown below if you have not changed the default security settings.
In order to run Mailpile you can temporarily alter the default Gatekeeper security settings in the Security & Privacy System Preferences pane (see Apple’s Gatekeeper documentation for more information), but the much easier way is to just right-click the icon, select “Open” from the contextual menu and confirm you want to launch the application (which may require admin authorization). In either case, after you started Mailpile for the first time, you can simply launch it as usual.
-
At this point you should be able to follow the Mailpile configuration wizard.
-
Mailpile also provides a convenient menu bar icon for quick access.
This documentation needs expanding.
If you want to help develop Mailpile by submitting pull requests, then some of these instructions might still be relevant. We will work to update this procedure as soon as possible!
Mailpile depends on lxml, which is a binder for two C libraries (libxml2 and libxslt). The GCC compiler needs to be installed on your os for those dependencies to work but is unfortunately not included with MacOS 10.6.8.
Some people are using XCode (that comes with GCC), others skip downloading the massive XCode installer and use GCC packaged by Kenneth Reitz. Long story short, to install Mailpile you have to have the GCC compiler installed, however you do it, and install lxml when GCC has been successfully installed. You will find several discussion threads regarding this issue if you run into any problems.
Download and Install Xcode Command Line Tools:
xcode-select --install
Download and Install PIP for Python:
cd /tmp
curl -L -o get-pip.py https://raw.github.com/pypa/pip/master/contrib/get-pip.py
sudo python get-pip.py
Install latest version of ‘lxml’ using Static Dependencies:
sudo STATIC_DEPS=true pip install lxml
OR install 'lxml' without pip, macports, or fink
cd /tmp
curl -o lxml-3.3.0.tgz http://lxml.de/files/lxml-3.3.0.tgz
tar -xzvf lxml-3.3.0.tgz
cd lxml-3.3.0
python setup.py build --static-deps --libxml2-version=2.8.0 --libxslt-version=1.1.24
sudo python setup.py install
Clone and Install Mailpile (in user 'Sites' directory, but any directory will do):
cd ~/Sites
git clone -b release/alpha https://github.com/pagekite/Mailpile.git
cd Mailpile
sudo pip install -r requirements.txt
If you run into an error like
clang: warning: unknown argument: '-mno-fused-madd' [-Wunused-command-line-argument-hard-error-in-future]
it is because you have a newer version of the Apple LLVM compiler in Xcode 5.1 that is stricter about flags, so prefix your build commands with this:
ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future
e.g.,
ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future python setup.py build --static-deps --libxml2-version=2.8.0 --libxslt-version=1.1.24 13ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future python setup.py build --static-deps --libxml2-version=2.8.0 --libxslt-version=1.1.24
and
sudo ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future pip install -r requirements.txt
[UGLY HACK WARNING - Mailpile calls python2 when opening, but in OS X this binary/symbolic link does not exist, instead we call python or python2.X directly. For this reason, we must accommodate Mailpile by creating a symbolic link in the usr/bin/ directory ]
Create symbolic link from 'python2.7' to 'python2':
sudo ln -s /usr/bin/python2.7 /usr/bin/python2
Finally - run Mailpile!
./mp
See "Getting started on linux" for more information on setting up Mailpile for the first time.