add notes about waitress to README

[chrisu/seepark.git] / web / README

diff --git a/web/README b/web/README
index e377dbd8b150833cbbb4fc84adda7493c816fbf5..2b6b5554efe5048b6f7733a1069605448484fe97 100644 (file)
--- a/web/README
+++ b/web/README
@@ -7,8 +7,54 @@ Option:
 -h 0.0.0.0
 at the end to listen on all interfaces, i.e.
 FLASK_APP=seepark_web.py FLASK_DEBUG=1 SEEPARKINI=~/seewasser.ini flask run -h 0.0.0.0
+(or :: instead of 0.0.0.0 for ipv4+ipv6)
+
 
 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
+
+version 1:
+
+1) add to web/seepark_web.py:
+from waitress import serve
+
+if __name__ == "__main__":
+    #app.run()
+    serve(app, listen='*:5000')
+
+2) run:
+SEEPARKINI=~/seewasser.ini python3 web/seepark_web.py
+
+version 2:
+
+1)
+touch web/__init__.py
+
+2)
+add to web/seepark_web.py:
+def create_app():
+    return app
+
+3)
+run:
+SEEPARKINI=~/seewasser.ini waitress-serve --port 8765 --call 'web.seepark_web:create_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