modoboa-installer

by modoboa

An installer for Modoboa

141 Stars 75 Forks Last release: Not found MIT License 255 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

modoboa-installer

|travis| |codecov|

An installer which deploy a complete mail server based on Modoboa.

.. warning::

This tool is still in beta stage, it has been tested on:

  • Debian Jessie (8) / Stretch (9) / Buster (10)
  • Ubuntu Trusty (14.04) and upper
  • CentOS 7

.. warning::

/tmp
partition must be mounted without the
noexec
option.

.. note::

The server (physical or virtual) running Modoboa needs at least 2GB of RAM in order to compile the required dependencies during the installation process. Passwords should not contain any special characters as they may cause the installation to fail

Usage::

$ git clone https://github.com/modoboa/modoboa-installer $ cd modoboa-installer $ sudo python3 run.py

If

python3
if not installed on your system, please install it.

A configuration file will be automatically generated the first time you run the installer, please don't copy the

installer.cfg.template
file manually.

The following components are installed by the installer:

  • Database server (PostgreSQL or MySQL)
  • Nginx and uWSGI
  • Postfix
  • Dovecot
  • Amavis (with SpamAssassin and ClamAV)
  • automx (autoconfiguration service)
  • OpenDKIM
  • Radicale (CalDAV and CardDAV server)

If you want to customize configuration before running the installer, run the following command::

$ ./run.py --stop-after-configfile-check

An interactive mode is also available::

$ ./run.py --interactive

Make your modifications and run the installer as usual.

By default, the latest Modoboa version is installed but you can select a previous one using the

--version
option::

$ sudo ./run.py --version=X.X.X

.. note::

Version selection is available only for Modoboa >= 1.8.1.

If you want more information about the installation process, add the

--debug
option to your command line.

Upgrade mode

An experimental upgrade mode is available.

.. note::

You must keep the original configuration file, ie the one used for the installation. Otherwise, you won't be able to use this mode.

You can activate it as follows::

$ sudo ./run.py --upgrade

It will automatically install latest versions of modoboa and its plugins.

Change the generated hostname

By default, the installer will setup your email server using the following hostname:

mail.
. If you want a different value, generate the configuration file like this::

$ ./run.py --stop-after-configfile-check

Then edit

installer.cfg
and look for the following section::

[general] hostname = mail.%(domain)s

Replace

mail
by the value you want to use and save your modifications.

Finally, run the installer without the

--stop-after-configfile-check
option.

Let's Encrypt certificate

.. warning::

Please note this option requires the hostname you're using to be valid (ie. it can be resolved with a DNS query) and to match the server you're installing Modoboa on.

If you want to generate a valid certificate using

Let's Encrypt
_, edit the
installer.cfg
file and modify the following settings::

[certificate] generate = true type = letsencrypt

[letsencrypt] email = [email protected]

Change the

email
setting to a valid value since it will be used for account recovery.

.. |travis| image:: https://travis-ci.org/modoboa/modoboa-installer.png?branch=master :target: https://travis-ci.org/modoboa/modoboa-installer .. |codecov| image:: http://codecov.io/github/modoboa/modoboa-installer/coverage.svg?branch=master :target: http://codecov.io/github/modoboa/modoboa-installer?branch=master

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.