From 79f4722878ece506a2e52b7beb3bec6e97773efb Mon Sep 17 00:00:00 2001 From: Abhilash Raj Date: Wed, 9 Aug 2017 17:31:11 -0700 Subject: [PATCH] Document that the static files need to be served using web server Fixes #58 --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 848e225..6279e9d 100644 --- a/README.md +++ b/README.md @@ -385,6 +385,19 @@ To move to uwsgi protocol in the above nginx configuration use this Please make sure that you are using v0.1.1 if you use this configuration. +### Serving static files + +UWSGI by default doesn't serve static files by default, so when running +`mailman-web` using the provided `docker-compose.yaml` file you won't see any +CSS or JS files being served. + +You will have to add an alias rule in your web server to serve the static +files. See [here][18] for instructions on how to configure you web server. The +STATIC_ROOT for you would be `/opt/mailman/web/static`. This method is +**highly** recommended for better performance reasons. + +### SSL certificates + SSL Certificates from Lets Encrypt need to be renewed every 90 days. You can setup a cron job to do the job. I have this small shell script(certbot-renew.sh) that you can put up in `/etc/cron.monthly` to get the job done. @@ -431,3 +444,4 @@ more details. [14]: https://docs.docker.com/engine/security/trust/content_trust/ [15]: http://docs.mailman3.org/en/latest/config-web.html#setting-up-email [17]: http://docs.mailman3.org/en/latest/prodsetup.html#nginx-configuration +[18]: http://docs.list.org/en/latest/pre-installation-guide.html#django-static-files