From 93f2bf15858d7431f0a72af086ed54262c230d8a Mon Sep 17 00:00:00 2001 From: Luke Murphy Date: Tue, 27 Jun 2017 18:36:46 +0100 Subject: [PATCH] Add note about conflicting `runserver` commands. (#685) --- docs/installation.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/installation.rst b/docs/installation.rst index 3cb4756..2002643 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -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 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 `_ + from `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 -----------------------------------------