2021-01-10 17:01:21 +00:00
|
|
|
Running the web server
|
|
|
|
|
======================
|
|
|
|
|
|
|
|
|
|
Once Supysonic is installed and configured, you'll have to start its web server
|
|
|
|
|
for the clients to be able to access the music. Here you have several options,
|
|
|
|
|
whether you want to run it as independant process(es), then possibly putting it
|
|
|
|
|
behind a reverse proxy, or running it as a WSGI application within Apache.
|
|
|
|
|
|
2021-11-06 16:51:54 +00:00
|
|
|
supysonic-server
|
|
|
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
|
But the easiest might be to use Supysonic's own server. It actually requires a
|
|
|
|
|
WSGI server library to run, so you'll first need to have either `Gevent`__,
|
|
|
|
|
`Gunicorn`__ or `Waitress`__ to be installed. Then you can start the server with
|
|
|
|
|
the following command::
|
|
|
|
|
|
|
|
|
|
supysonic-server
|
|
|
|
|
|
|
|
|
|
And it will start to listen on all IPv4 interfaces on port 5722.
|
|
|
|
|
|
|
|
|
|
This command allows some options, more details are given on its manpage:
|
|
|
|
|
:doc:`/man/supysonic-server`.
|
|
|
|
|
|
|
|
|
|
__ https://www.gevent.org
|
|
|
|
|
__ https://gunicorn.org/
|
|
|
|
|
__ https://docs.pylonsproject.org/projects/waitress/en/stable/index.html
|
|
|
|
|
|
|
|
|
|
Other options
|
|
|
|
|
^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
|
You'll find some other common (and less common) deployment option below:
|
2021-01-10 17:01:21 +00:00
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 2
|
|
|
|
|
|
|
|
|
|
wsgi-standalone
|
|
|
|
|
apache
|
2021-01-16 15:09:53 +00:00
|
|
|
other
|
|
|
|
|
|
|
|
|
|
As Supysonic is a WSGI application, you have numerous deployment options
|
|
|
|
|
available to you. If you want to deploy it to a WSGI server not listed here,
|
|
|
|
|
look up the server documentation about how to use a WSGI app with it. When
|
2021-01-17 16:06:44 +00:00
|
|
|
setting one of those, you'll want to call the :py:func:`create_application`
|
|
|
|
|
factory function from module :py:mod:`supysonic.web`.
|
