collectstatic for production in Django

Introduction

The collectstatic command gathers all static files from your Django apps into one place. This makes it easy to serve them efficiently in production.

When you want to prepare your static files (CSS, JavaScript, images) for deployment.

Before deploying your Django project to a live server.

When you add or update static files and want to make sure the server uses the latest versions.

To organize static files from multiple apps into a single folder for easy serving.

When using a web server like Nginx or Apache to serve static files separately from Django.

Syntax

Django

python manage.py collectstatic

This command copies static files into the directory set by STATIC_ROOT in your settings.

You usually run this command once before deploying your site.

Examples

Runs the command and asks for confirmation before copying files.

Django

python manage.py collectstatic

Runs the command without asking for confirmation, useful for automated deployments.

Django

python manage.py collectstatic --noinput

Clears the target directory before collecting static files.

Django

python manage.py collectstatic --clear

Sample Program

This example shows the minimal settings needed and the command to collect static files. After running, all static files from apps and STATICFILES_DIRS are copied to staticfiles folder.

Django

# settings.py
STATIC_URL = '/static/'
STATIC_ROOT = BASE_DIR / 'staticfiles'

# Terminal command
python manage.py collectstatic

# Output example
# You will see lines like:
# 127 static files copied to '/path/to/project/staticfiles'

Important Notes

Make sure STATIC_ROOT is set and points to a folder outside your app directories.

Do not serve static files with Django in production; use a web server instead.

Run collectstatic every time you change static files before deploying.

Summary

collectstatic gathers all static files into one folder for easy serving.

Run it before deploying your Django project to production.

Set STATIC_ROOT in settings to tell Django where to collect files.