github/supysonic
1
0
Fork 0
mirror of https://github.com/spl0k/supysonic.git synced 2024-12-22 08:56:17 +00:00
Code Issues Releases Wiki Activity

Small update on WSGI containers doc

Browse Source
This commit is contained in:
Alban Féron 2021-11-12 12:22:16 +01:00
parent a88e261a8d
commit 64475a8dfa
No known key found for this signature in database
GPG Key ID: 8CE0313646D16165
1 changed files with 33 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/setup/deploying/wsgi-standalone.rst
View File

@ -25,13 +25,21 @@ IPv4 interfaces on port 5722 (``-b 0.0.0.0:5722``)::
$ gunicorn -w 4 -b 0.0.0.0:5722 "supysonic.web:create_application()" $ gunicorn -w 4 -b 0.0.0.0:5722 "supysonic.web:create_application()"
.. note::
While :command:`gunicorn` provides way more options to configure its
behaviour than :command:`supysonic-server` will ever do, the above example is
actually equivalent to::
$ supysonic-server -S gunicorn --processes 4
__ https://gunicorn.org/ __ https://gunicorn.org/
uWSGI uWSGI
----- -----
`uWSGI`__ is a fast application server written in C. It is very configurable `uWSGI`__ is a fast application server written in C. It is very configurable
which makes it more complicated to setup than gunicorn. which makes it more complicated to setup than Gunicorn.
To use it, install the package ``uwsgi`` with either :command:`pip` or To use it, install the package ``uwsgi`` with either :command:`pip` or
:command:`apt`. Using the later, wou might also need the additional package :command:`apt`. Using the later, wou might also need the additional package
@ -59,3 +67,27 @@ double-quotes).
__ https://uwsgi-docs.readthedocs.io/en/latest/ __ https://uwsgi-docs.readthedocs.io/en/latest/
__ https://flask.palletsprojects.com/en/2.0.x/deploying/uwsgi/ __ https://flask.palletsprojects.com/en/2.0.x/deploying/uwsgi/
Waitress
========
`Waitress`__ is meant to be a production-quality pure-Python WSGI server with
very acceptable performance. It has no dependencies except ones which live in
the Python standard library.
As for Gunicorn, using it to run Supysonic is rather simple. Install it using
either :command:`pip install waitress` or
:command:`apt install python3-waitress`. Then start the server this way::
$ waitress-serve --call supysonic.web:create_application
Waitress behaviour can be tuned through various command-line options -- see
:command:`waitress-serve --help`. If none of them are relevant to you,
:command:`supysonic-server` can actually be used instead::
$ supysonic-server -S waitress
Both commands are equivalent, with the only difference being the port they
listen on.
__ https://docs.pylonsproject.org/projects/waitress/en/stable/index.html