Installation Instructions
=========================

.. toctree::
    :caption: Quick setup guide
    :maxdepth: 1
    :hidden:

    virtualenv
    docker
    distro

Mailman Suite can be installed in one of several ways.


Python "pip" / "venv" / "virtualenv" Setup (recommended)
--------------------------------------------------------

This is the recommended way to install the Mailman Suite for a Production
instance. It requires more technical knowledge and following of extra Python 
steps and configuration to make function fully.

It is possible to install Mailman Suite with one of several methods.

* :ref:`virtualenv-install`


Distribution-provided Packages
------------------------------

Some Linux distributions may provide packages of the various components of the 
Mailman suite in their repositories.

This may restrict you from updating Mailman in the future by being dependent on 
the distribution's provided packages, and may not get you complete support for any 
issues you may run into via the Mailman support lists.

These are the currently documented installation methods using Distribution-provided 
packages:

* Debian - :ref:`debian-install`


Docker Containers
-----------------

It is also possible to deploy Mailman Suite in a Docker container, however, like 
distribution-provided packages, complete support for any issues may be limited.

* :ref:`docker-install`