Management Commands
===================

.. highlight:: console

.. _collectstatic:

collectstatic
-------------

Collects the static files from all installed apps and copies them to the
:attr:`~django.conf.settings.STATICFILES_STORAGE`.

Duplicate file names are resolved in a similar way to how template resolution
works. Files are initially searched for in
:attr:`~django.conf.settings.STATICFILES_DIRS` locations, followed by apps in
the order specified by the ``INSTALLED_APPS`` setting.

Some commonly used options are:

``--noinput``
    Do NOT prompt the user for input of any kind.

``-i PATTERN`` or ``--ignore=PATTERN``
    Ignore files or directories matching this glob-style pattern. Use multiple
    times to ignore more.

``-n`` or ``--dry-run``
    Do everything except modify the filesystem.

``-l`` or ``--link``
    Create a symbolic link to each file instead of copying.

``--no-default-ignore``
    Don't ignore the common private glob-style patterns ``'CVS'``, ``'.*'``
    and ``'*~'``.

``-c`` or ``--clear``

    .. versionadded:: 1.1

    Clear the existing files before trying to copy or link the original file.

``--no-post-process``

    .. versionadded:: 1.1

    Don't call the
    :meth:`~staticfiles.storage.StaticFilesStorage.post_process`
    method of the configured
    :attr:`~django.conf.settings.STATICFILES_STORAGE` storage backend.

For a full list of options, refer to the collectstatic management command help
by running::

   $ python manage.py collectstatic --help

.. _findstatic:

findstatic
----------

Searches for one or more relative paths with the enabled finders::

   $ python manage.py findstatic css/base.css admin/js/core.css
   /home/special.polls.com/core/media/css/base.css
   /home/polls.com/core/media/css/base.css
   /home/polls.com/src/django/contrib/admin/media/js/core.js

By default, all matching locations are found. To only return the first match
for each relative path, use the ``--first`` option::

   $ python manage.py findstatic css/base.css --first
   /home/special.polls.com/core/media/css/base.css

This is a debugging aid; it'll show you exactly which static file will be
collected for a given path.

runserver
---------

Overrides the core ``runserver`` command if the ``staticfiles`` app
is installed (in ``INSTALLED_APPS``) and adds automatic serving of static
files and the following new options.

``--nostatic``

Use the ``--nostatic`` option to disable serving of static files with the
``staticfiles`` app entirely. This option is only available if the
``staticfiles`` app is in your project's ``INSTALLED_APPS`` setting.

Example usage::

    django-admin.py runserver --nostatic

``--insecure``

Use the ``--insecure`` option to force serving of static files with the
``staticfiles`` app even if the ``DEBUG`` setting is ``False``.

.. warning:: By using this you acknowledge the fact that it's
   **grossly inefficient** and probably **insecure**.

   This is only intended for local development, should
   **never be used in production** and is only available if the
   ``staticfiles`` app is in your project's ``INSTALLED_APPS`` setting.

Example usage::

    django-admin.py runserver --insecure