X-Git-Url: https://git.toastfreeware.priv.at/chrisu/seepark.git/blobdiff_plain/32289b0c8cb2b0d0ae9436fdad60238ea68f87f5..c7e259af5499c1cd5b15389936fec83a0cb2554c:/web/README

diff --git a/web/README b/web/README
index d23bdc8..69dacc1 100644
--- a/web/README
+++ b/web/README
@@ -1,4 +1,4 @@
-Needed packages: (python3-flask python3-sqlalchemy) python3-mysqldb python3-flask-sqlalchemy
+Needed packages: (python3-flask python3-sqlalchemy) python3-mysqldb python3-flask-sqlalchemy python3-sphinxcontrib.httpdomain
 
 Start with:
 FLASK_APP=seepark_web.py FLASK_DEBUG=1 SEEPARKINI=~/seewasser.ini flask run
@@ -14,3 +14,43 @@ Go to:
 http://127.0.0.1:5000/
 or http://<ipaddress>:5000/
 if the app is running on a different machine
+
+---
+
+notes on a "production" server:
+
+needed: python3-waitress
+
+run (in folder web):
+SEEPARKINI=~/seewasser.ini waitress-serve --port 8765 'seepark_web:app'
+
+links:
+
+http://flask.pocoo.org/docs/1.0/tutorial/deploy/
+http://flask.pocoo.org/docs/1.0/tutorial/factory/
+https://github.com/pallets/flask/blob/1.0.2/examples/tutorial/flaskr/__init__.py
+
+https://docs.pylonsproject.org/projects/waitress/en/latest/
+https://docs.pylonsproject.org/projects/waitress/en/latest/runner.html#runner
+
+https://gr33ndata.blogspot.com/2012/01/waitress-flask.html
+
+---
+
+Generate documentation:
+cd doc
+SEEPARKINI=~/seewasser.ini make web
+
+To make this run on Debian Buster we had to do the following first
+
+$ cd /home/philipp/opt/pyenv
+$ virtualenv -p python3 --system-site-packages seepark
+$ source seepark/bin/activate
+$ pip install --upgrade sphinx
+$ pip install --upgrade sphinxcontrib-httpdomain
+
+
+---
+
+Execute unittests
+SEEPARKINI=~/seewasser.ini python3 -m unittest seepark_web_tests.py