diff --git a/README.txt b/README.txt index ba68681..57f5b6a 100644 --- a/README.txt +++ b/README.txt @@ -53,7 +53,32 @@ folk/folk.csv table - a year doesn't exist until that is done. Running a Troggle server ------------------------ -For high volume use, Troggle should be run using a web server like apache. However, a quick way to get started is to use the development server built into Django. +For high volume use, Troggle should be run using a web server like apache. However, a quick way to get started is to use the development server built into Django. This is limited though: directory +redirection needs apache. To do this, run "python manage.py runserver" from the troggle directory. + +Running a Troggle server with Apache +------------------------------------ +Troggle also needs these aliases to be configured. These are set in +/home/expo/config/apache/expo.conf +on the expo server. + +At least these need setting: +DocumentRoot /home/expo/expoweb +WSGIScriptAlias / /home/expo/troggle/wsgi.py +Alias /expofiles /home/expo/expofiles +Alias /photos /home/expo/webphotos +Alias /map /home/expo/expoweb/map +Alias /javascript /usr/share/javascript +Alias /static/ /home/expo/static/ +ScriptAlias /repositories /home/expo/config/apache/services/hgweb/hgweb.cgi + +(The last is just for mercurial which will be remoived during 2020). + +Unlike the "runserver" method, apache requires a restart before it will use +any changed files: + +apache2ctl stop +apache2ctl start