Note
This installation guide covers Postorius, the web user interface for GNU Mailman 3. To install GNU Mailman follow the instructions in the documentation.
If you are looking for an easy way to set up the whole GNU Mailman 3 suite (GNU Mailman 3, Postorius, Hyperkitty and mailmanclient), check out the mailman-bundler project on GitLab.
If you just want to install the latest release of Postorius, install it from PyPi:
$ pip install postorius
or:
$ easy_install postorius
If you want to always be up to date with the latest development version, you should install Postorius using git:
$ git clone https://gitlab.com/mailman/postorius.git
$ cd postorius
$ python setup.py develop
Since you have now installed the necessary packages to run Postorius, it’s time to setup your Django site.
First, get the project directory from gitlab:
$ git clone https://gitlab.com/mailman/postorius_standalone.git
Change the database setting in postorius_standalone/settings.py to your preferred database, if you want something other than SQlite.
Note
Detailed information on how to use different database engines can be found in the Django documentation.
Third, prepare the database:
$ cd postorius_standalone
$ python manage.py migrate
$ cd ..
This will create the .db file (if you ar using SQLite) and will setup all the necessary db tables.
To create a superuser which will act as an admin account for Postorius, run the following commands:
$ cd postorius_standalone
$ python manage.py createsuperuser
$ cd ..
The quickest way to run Postorius is to just start the development server:
$ cd postorius_standalone
$ python manage.py runserver
Warning
You should use the development server only locally. While it’s possible to make your site publicly available using the dev server, you should never do that in a production environment.