Add note about conflicting runserver commands. (#685)

This commit is contained in:
Luke Murphy 2017-06-27 18:36:46 +01:00 committed by Andrew Godwin
parent 26916cccc7
commit 93f2bf1585

View File

@ -20,6 +20,14 @@ Once that's done, you should add ``channels`` to your
That's it! Once enabled, ``channels`` will integrate itself into Django and That's it! Once enabled, ``channels`` will integrate itself into Django and
take control of the ``runserver`` command. See :doc:`getting-started` for more. take control of the ``runserver`` command. See :doc:`getting-started` for more.
.. note::
Please be wary of any other third-party apps that require an overloaded or
replacement ``runserver`` command. Channels provides a separate
``runserver`` command and may conflict with it. An example
of such a conflict is with `whitenoise.runserver_nostatic <https://github.com/evansd/whitenoise/issues/77>`_
from `whitenoise <https://github.com/evansd/whitenoise>`_. In order to
solve such issues, try moving ``channels`` to the top of your ``INSTALLED_APPS``
or remove the offending app altogether.
Installing the latest development version Installing the latest development version
----------------------------------------- -----------------------------------------