Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

[1.5.x] Fixed #20284 - Added a note about DEBUG in static file docs.

Thanks wim@ for the suggestion and Nicolas Noé for the patch.

Backport of 2c84f44 from master
  • Loading branch information...
commit 694f4ff9e28aac1ec0309fd379b4b53067c6c52f 1 parent 38fbc83
@timgraham timgraham authored
Showing with 14 additions and 2 deletions.
  1. +14 −2 docs/howto/static-files/index.txt
16 docs/howto/static-files/index.txt
@@ -35,8 +35,20 @@ Configuring static files
4. Store your static files in a folder called ``static`` in your app. For
example ``my_app/static/my_app/myimage.jpg``.
-Now, if you use ``./ runserver``, all static files should be served
-automatically at the :setting:`STATIC_URL` and be shown correctly.
+.. admonition:: Serving the files
+ In addition to these configuration steps, you'll also need to actually
+ serve the static files.
+ During development, this will be done automatically if you use
+ :djadmin:`runserver` and :setting:`DEBUG` is set to ``True`` (see
+ :func:`django.contrib.staticfiles.views.serve`).
+ This method is **grossly inefficient** and probably **insecure**,
+ so it is **unsuitable for production**.
+ See :doc:`/howto/static-files/deployment` for proper strategies to serve
+ static files in production environments.
Your project will probably also have static assets that aren't tied to a
particular app. In addition to using a ``static/`` directory inside your apps,
Please sign in to comment.
Something went wrong with that request. Please try again.