github-jwinterm/modoboa
1
0
Fork 0
mirror of https://github.com/jwinterm/modoboa.git synced 2026-10-17 05:41:25 +02:00
Code Issues Packages Projects Releases Wiki Activity

Comment and improve highlight in 'Prepare the system' doc

Browse Source
This commit is contained in:
Jérôme Lebleu
2020-05-11 14:39:51 +02:00
parent b084e3b46e
commit 8c542dd405
1 changed files with 34 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/manual_installation/modoboa.rst
+34 -33
View File
@@ -10,53 +10,54 @@ This section describes the installation of the web interface (a
Prepare the system
------------------
First of all, we recommand the following context:
First of all, we recommend the following context:
* Use a dedicated system user
* Use a `virtualenv <http://www.virtualenv.org/en/latest/>`_ to
install the application because it will isolate it (and its
* A dedicated system user
* A `virtual environment
<https://packaging.python.org/tutorials/installing-packages/#creating-virtual-environments>`_
to install the application because it will isolate it (and its
dependencies) from the rest of your system
The following example illustrates how to realize this (Debian like system):
The following example illustrates how to realize this on Debian-based
distributions using `virtualenv <https://virtualenv.pypa.io/en/stable/>`_:
.. sourcecode:: bash
.. code-block:: console
> sudo apt-get install python-virtualenv python-pip
> sudo useradd modoboa
> sudo -i -u modoboa
> virtualenv env
> source env/bin/activate
(env)> pip install -U pip
# apt-get install virtualenv python3-pip
# useradd modoboa # create a dedicated user
# su -l modoboa # log in as the newly created user
$ virtualenv --python python3 ./env # create the virtual environment
$ source ./env/bin/activate # activate the virtual environment
Modoboa depends on external tools and some of them require compilation
so you need a compiler and a few C libraries. Make sure to install the
following system packages according to your distribution:
+------------------------------+
|Debian / Ubuntu |
+==============================+
|build-essential python-dev |
|libxml2-dev libxslt-dev |
|libjpeg-dev librrd-dev |
|rrdtool libffi-dev libssl-dev |
| |
+------------------------------+
+-------------------------------+
| Debian / Ubuntu |
+===============================+
| build-essential python3-dev |
| libxml2-dev libxslt-dev |
| libjpeg-dev librrd-dev |
| rrdtool libffi-dev libssl-dev |
+-------------------------------+
+------------------------------+
|CentOS |
+==============================+
|gcc gcc-c++ python-devel |
|libxml2-devel libxslt-devel |
|libjpeg-turbo-devel |
|rrdtool-devel rrdtool |
|libffi-devel |
+------------------------------+
+-----------------------------+
| CentOS |
+=============================+
| gcc gcc-c++ python3-devel |
| libxml2-devel libxslt-devel |
| libjpeg-turbo-devel |
| rrdtool-devel rrdtool |
| libffi-devel |
+-----------------------------+
Then, install Modoboa:
.. sourcecode:: bash
Then, install Modoboa by running:
(env)> pip install modoboa
.. code-block:: console
(env)$ pip install modoboa
.. _database: