From a30f4b1977be6a517ab451e789e52c32ccf48eed Mon Sep 17 00:00:00 2001 From: Abhilash Raj Date: Wed, 17 Mar 2021 00:39:17 -0700 Subject: [PATCH] Remove install instructions and point to the official doc. --- src/postorius/doc/deployment.rst | 142 +++------------------------------------ 1 file changed, 9 insertions(+), 133 deletions(-) rewrite src/postorius/doc/deployment.rst (98%) diff --git a/src/postorius/doc/deployment.rst b/src/postorius/doc/deployment.rst dissimilarity index 98% index 4eef7cba..6080f69e 100644 --- a/src/postorius/doc/deployment.rst +++ b/src/postorius/doc/deployment.rst @@ -1,133 +1,9 @@ -============ -Deployment -============ - -Postorius support Python 3.5+ and Django 1.11+. - -.. note:: - This guide covers deployment options of Postorius. - - -Nginx with uwsgi -================ - -.. note:: - Please refer to nginx and uwsgi documentation for explanation of the shown - snippets. - -Below is an example uwsgi configuration file: - -:: - - [uwsgi] - - chdir = /srv/django/mailman - module = example_project.wsgi - virtualenv = /srv/django/mailman/env - - master = true - processes = 4 - socket = /run/uwsgi/mailman.sock - #chmod-socket = 666 - - vacuum = true - plugin = python2 - - uid = http - gid = http - -And a nginx server section to with it: - -:: - - upstream mailman { - server unix:///run/uwsgi/mailman.sock; - } - - server { - listen 80; - # TODO Replace with your domain - server_name lists.example.com; - return 301 https://$server_name$request_uri; - - } - - ## Config for server secured with https - server { - listen 443; - - # TODO Replace with your domain - server_name lists.example.com; - - - ssl on; - # TODO Replace with your crt and key - ssl_certificate /etc/nginx/keys/lists.example.com.crt; - ssl_certificate_key /etc/nginx/keys/lists.example.com.key; - ssl_session_timeout 5m; - ssl_ciphers 'AES128+EECDH:AES128+EDH'; - ssl_protocols TLSv1 TLSv1.1 TLSv1.2; - ssl_prefer_server_ciphers on; - add_header Strict-Transport-Security "max-age=63072000; includeSubdomains; preload"; - - charset utf-8; - - # max upload size - client_max_body_size 75M; # adjust to taste - - location /static { - # TODO Adjust to your static location - alias /srv/django/mailman/public/static; - } - - # Finally, send all non-media requests to the Django server. - location / { - uwsgi_pass mailman; - include /etc/nginx/uwsgi_params; # the uwsgi_params file you installed - } - } - - -Apache with mod_wsgi -==================== - -.. note:: - This guide assumes that you know how to setup a VirtualHost with Apache. - If you are using SQLite, the ``.db`` file as well as its folder need to be - writable by the web server. - -These settings need to be added to your Apache VirtualHost: - -:: - - Alias /static /srv/django/mailman/public/static - - Order deny,allow - Allow from all - - - WSGIScriptAlias / /srv/django/mailman/srv/postorius.wsgi - - Order deny,allow - Allow from all - - -The first Alias serves the static files (CSS, JS, Images, etc.). The -WSGIScriptAlias serves the Django application. The paths need to be changed -depending on which location you have your postorius project in. - -Final setup instructions -======================== - -We're almost ready. But you need to create translations and collect the static -files from Postorius (which resides somewhere on your pythonpath) to be able to -serve them from the site directory. All you have to do is to change into the -postorius project directory and run: - -:: - - $ mkdir locale - $ python manage.py compilemessages - $ python manage.py collectstatic - -After reloading the webserver Postorius should be running! +============ +Deployment +============ + +Postorius support Python 3.6+ and Django 2.2+. + +Head over to ``Mailman Suite installation guide +`_ for a detailed +installtion guide including Mailman Core, Postorius and Hyperkitty. -- 2.11.4.GIT