How to serve static files in Django framework 

3 min read
zen8labs serving static files in Django framework

Serving static files is an important part of deploying a web application. At zen8labs we use a variety of platforms such as Django. This guide provides the basic steps and essential considerations for configuring and serving static files in Django.

1. Project Directory Structure 

Before diving into configuration, let’s look at a typical Django project directory structure:

zen8labs serving static files in django framework 1
  • static/: This is the directory that STATIC_ROOT will point to. It should be empty during development, as it will be used to store all collected static files after running the collectstatic command.
  • static_files/: This directory contains the static files you will create and manage during development. You can create subdirectories like css/, js/, and other types of static files here. STATICFILES_DIRS will point to this directory.

Now, we have a basic understanding of the project directory structure. Let’s go to the configuration setting.

2. Configuration Settings 

zen8labs serving static files in django framework 2
  • STATIC_URL: The URL at which static files will be accessed, e.g., /static/. This is the base URL where static files will be served.
  • STATIC_ROOT: The directory where Django will collect all static files when running the collectstatic command. You should not place any files in the directory pointed to by STATIC_ROOT.
  • STATICFILES_DIRS: A list of directories where Django will look for additional static files. You should place your static files here instead of in the STATIC_ROOT directory.

3. Serving Static Files in Development 

When DEBUG = True, Django automatically serves static files using the django.contrib.staticfiles application.

zen8labs serving static files in django framework 3

In the development environment, no additional steps are necessary. Django will automatically serve static files from the directories listed in STATICFILES_DIRS and from the static files of installed apps.

4. Serving Static Files in Production 

When DEBUG = False, Django does not automatically serve static files. This is for security and performance reasons. In a production environment, serving static files should be handled by a web server like Nginx, rather than Django. The web server will efficiently serve static files and reduce the load on your Django application. 

zen8labs serving static files in django framework 4

The collectstatic command will gather all static files from the directories listed in STATICFILES_DIRS and from installed apps, and place them in the STATIC_ROOT  

zen8labs serving static files in django framework 5

Here is a basic Nginx configuration to serve static files from the STATIC_ROOT directory: 

zen8labs serving static files in django framework 6

Note: When overriding the nginx.conf configuration, ensure you include mime.types so Nginx can correctly handle different file types. Without mime.types, Nginx may not serve static files correctly.

Conclusion 

This guide has covered how to configure Django to serve static files in both development and production environments. Remember that using Nginx to serve static files is an effective way to ensure performance and security for your application. Good luck with your deployment, if you want to gain insights into an array of IT areas, then zen8labs is your one stop shop for all things IT related!

Linh Phung, Software Engineer

Related posts

Programming is often seen as a complex and technical field, but at its heart, it's really about solving the problem. Our new blog introduces a creative approach
4 min read
Did you know two features of Sales and Purchase order used in Odoo? Check this blog to get a better understanding of both Sales and Purchase orders used in Odoo
5 min read
Being able to do test scripts in a safe but creative manner is a challenge for any IT company. Postman helps people have a safe space to create test scripts.
11 min read