django-staticfiles python

[Unmaintained] A Django app that provides helpers for serving static files, used in Django and Pinax.

3 years after

================== django-staticfiles

This is a Django app that provides helpers for serving static files.

Django developers mostly concern themselves with the dynamic parts of web applications -- the views and templates that render new for each request. But web applications have other parts: the static media files (images, CSS, Javascript, etc.) that are needed to render a complete web page.

For small projects, this isn't a big deal, because you can just keep the media somewhere your web server can find it. However, in bigger projects -- especially those comprised of multiple apps -- dealing with the multiple sets of static files provided by each application starts to get tricky.

That's what staticfiles is for:

Collecting static files from each of your Django apps (and any other
place you specify) into a single location that can easily be served in

The main website for django-staticfiles is where you can also file tickets.

.. note:: django-staticfiles is now part of Django (since 1.3) as django.contrib.staticfiles.

The django-staticfiles 0.3.X series will only receive security and data loss bug fixes after the release of django-staticfiles 1.0. Any Django 1.2.X project using django-staticfiles 0.3.X and lower should be upgraded to use either Django >= 1.3's staticfiles app or django-staticfiles >= 1.0 to profit from the new features and stability.

You may want to chose to use django-staticfiles instead of Django's own staticfiles app since any new feature (additionally to those backported from Django) will be released first in django-staticfiles.


  • Use your favorite Python packaging tool to install staticfiles from PyPI_, e.g.::

    pip install django-staticfiles

    You can also install the in-development version_ of django-staticfiles with pip install django-staticfiles==dev.

  • Added "staticfiles" to your INSTALLED_APPS setting::





  • Set your STATIC_URL setting to the URL that handles serving static files::

    STATIC_URL = "/static/"

  • In development mode (when DEBUG = True) the runserver command will automatically serve static files::

    python runserver

  • Once you are ready to deploy all static files of your site in a central directory (STATIC_ROOT) to be served by a real webserver (e.g. Apache, Cherokee, Lighttpd, Nginx etc.), use the collectstatic management command::

    python collectstatic

    See the webserver's documentation for descriptions how to setup serving the deployment directory (STATIC_ROOT).

  • (optional) In case you use Django's admin app, make sure the ADMIN_MEDIA_PREFIX setting is set correctly to a subpath of STATIC_URL::


.. .. _in-development version: .. _PyPI: .. _Apache: .. _Lighttpd: .. _Nginx: .. _Cherokee:

Related Repositories



A Django staticfiles post-processor for optimizing with RequireJS. ...



A Django application that handles large file transfers ...



Simply the bootstrap static files WITH plugins ...



Django staticfiles with famfamfam silk and flag icon sets ...



Django app - bundles jQuery for django-staticfiles ...

Top Contributors

jezdez carljm idan SmileyChris brosner dbinit durden pabluk


-   1.2.1 zip tar
-   1.2 zip tar
-   1.1.2 zip tar
-   1.1.1 zip tar
-   1.1 zip tar
-   1.0.1 zip tar
-   1.0 zip tar
-   1.0rc2 zip tar
-   1.0rc1 zip tar
-   1.0b1 zip tar
-   1.0a5 zip tar
-   1.0a4 zip tar
-   1.0a3 zip tar
-   1.0a2 zip tar
-   1.0a1 zip tar
-   0.3.4 zip tar
-   0.3.3 zip tar
-   0.3.2 zip tar
-   0.3.1 zip tar
-   0.3.0 zip tar
-   0.2.0 zip tar
-   0.1.2 zip tar
-   0.1.1 zip tar
-   0.1.0 zip tar