# Installation

1. Either check out Pipeline from GitHub or to pull a release off PyPI

       pip install django-pipeline

2. Add ‘pipeline’ to your `INSTALLED_APPS`

       INSTALLED_APPS = (
           'pipeline',
       )

3. Use a pipeline storage for `STATICFILES_STORAGE`

       STATICFILES_STORAGE = 'pipeline.storage.PipelineManifestStorage'

4. Add the `PipelineFinder` to `STATICFILES_FINDERS`

       STATICFILES_FINDERS = (
           'django.contrib.staticfiles.finders.FileSystemFinder',
           'django.contrib.staticfiles.finders.AppDirectoriesFinder',
           'pipeline.finders.PipelineFinder',
       )

Note

You need to use `Django>=1.11` to be able to use this version of pipeline.

## Upgrading from 1.3

To upgrade from pipeline 1.3, you will need to follow these steps:

1. Update templates to use the new syntax

   >     {# pipeline<1.4 #}
   >     {% load compressed %}
   >     {% compressed_js 'group' %}
   >     {% compressed_css 'group' %}

   >     {# pipeline>=1.4 #}
   >     {% load pipeline %}
   >     {% javascript 'group' %}
   >     {% stylesheet 'group' %}

2. Add the `PipelineFinder` to `STATICFILES_FINDERS`

       STATICFILES_FINDERS = (
           'django.contrib.staticfiles.finders.FileSystemFinder',
           'django.contrib.staticfiles.finders.AppDirectoriesFinder',
           'pipeline.finders.PipelineFinder',
       )

## Upgrading from 1.5

To upgrade from pipeline 1.5, you will need update all your `PIPELINE_*` settings and move them under the new `PIPELINE` setting. See Configuration.

## Recommendations

Pipeline’s default CSS and JS compressor is Yuglify. Yuglify wraps UglifyJS and cssmin, applying the default YUI configurations to them. It can be downloaded from: https://github.com/yui/yuglify/.

If you do not install yuglify, make sure to disable the compressor in your settings.