Go to file
Andreas Schneider 569c5c662b Accepting request 1123461 from home:darix:branches:devel:languages:python:mailman
- make it easier to notice to keep buildrequires and runtime
  requires version limits in sync. This will also help us to notice
  early when the version of other libraries do not match the
  requires encoded in the source code.

OBS-URL: https://build.opensuse.org/request/show/1123461
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:mailman/python-postorius?expand=0&rev=52
2023-11-06 08:15:24 +00:00
.gitattributes - initial version 1.3.0 [SLE-7686] 2019-11-15 10:12:48 +00:00
.gitignore - initial version 1.3.0 [SLE-7686] 2019-11-15 10:12:48 +00:00
postorius-1.3.10.tar.gz Accepting request 1122606 from home:gladiac:mailman 2023-11-02 12:42:21 +00:00
postorius-manage.sh Remove link to Factory. 2021-11-17 08:26:15 +00:00
postorius-settings.patch Accepting request 1036470 from home:gladiac:branches:devel:languages:python:mailman 2022-11-17 15:12:06 +00:00
postorius.uwsgi Remove link to Factory. 2021-11-17 08:26:15 +00:00
python-postorius-rpmlintrc Accepting request 986687 from home:bnavigator:branches:devel:languages:python:mailman 2022-07-04 18:07:26 +00:00
python-postorius.changes Accepting request 1123461 from home:darix:branches:devel:languages:python:mailman 2023-11-06 08:15:24 +00:00
python-postorius.spec Accepting request 1123461 from home:darix:branches:devel:languages:python:mailman 2023-11-06 08:15:24 +00:00
README.SUSE.md Remove link to Factory. 2021-11-17 08:26:15 +00:00

Postorius

Configuration

The web application is configured in /etc/postorius/settings_local.py which is included by the default configuration in /srv/www/webapps/postorius/settings.py.

  1. Optional: Change the default secret for the application: We already created one, but feel free to replace with a stronger alternative.

    /etc/postorius/settings_local.py:

    SECRET_KEY = 'something-very-secret'
    
  2. Make sure to disable debugging when running in production:

    /etc/postorius/settings_local.py:

    DEBUG = False
    
  3. The valid hosts or domain names for the application need to be defined:

    /etc/postorius/settings_local.py:

     ALLOWED_HOSTS = [
         'localhost',
         'lists.example.com'
     ]
    
  4. To be able to configure a running mailman instance configuration options for its REST API have to be added to postorius' configuration.

    /etc/postorius/settings_local.py

    MAILMAN_REST_API_URL = 'http://localhost:8001'
    MAILMAN_REST_API_USER = 'rest_admin'
    MAILMAN_REST_API_PASS = 'rest_admin_password'
    
  5. Add a valid email configuration

    /etc/postorius/settings_local.py:

     EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
     EMAIL_HOST = 'localhost'
     EMAIL_PORT = 25
     EMAIL_HOST_USER = <username>
     EMAIL_HOST_PASSWORD = <password>
    
  6. Optional: Configure postgres or another database (default: sqlite3)

  7. Create and setup the database

    postorius-manage migrate

  8. Create admin user

    postorius-manage createsuperuser

Apache2

To configure postorius with Apache and uwsgi, just add the follwing lines to a vhost:

ProxyPass /.well-known/acme-challenge !
ProxyPassMatch ^/static !
ProxyPass / unix:/run/uwsgi/uwsgi-postorius.sock|uwsgi://localhost/
<Directory /srv/www/webapps/mailman/postorius>
    Require all granted
</Directory>