Gzip configuration (types, min_length) in Nginx - Commands & Configuration

Introduction

Web servers can send files faster by compressing them before sending. Gzip compression reduces file size, making websites load quicker and saving bandwidth.

When you want to speed up your website by sending smaller files to browsers.

When you want to reduce data usage for users on slow or limited internet connections.

When you want to compress only certain types of files like HTML, CSS, or JavaScript.

When you want to avoid compressing very small files that don't benefit much from compression.

When you want to improve SEO by making your site load faster.

Config File - nginx.conf

nginx.conf

http {
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/rss+xml text/javascript;
    gzip_min_length 1000;
    server {
        listen 80;
        server_name example.com;
        location / {
            root /usr/share/nginx/html;
            index index.html;
        }
    }
}

gzip on; enables gzip compression.

gzip_types lists the file types to compress, like text and JavaScript files.

gzip_min_length sets the minimum file size in bytes to compress; files smaller than this won't be compressed.

The server block defines the website settings.

Commands

Check the nginx configuration file for syntax errors before applying changes.

Terminal

sudo nginx -t

Expected Output

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok

nginx: configuration file /etc/nginx/nginx.conf test is successful

Reload nginx to apply the new gzip compression settings without stopping the server.

Terminal

sudo systemctl reload nginx

Expected Output

No output (command runs silently)

Request the headers of the index.html page asking for gzip encoding to verify compression is active.

Terminal

curl -H "Accept-Encoding: gzip" -I http://example.com/index.html

Expected Output

HTTP/1.1 200 OK

Server: nginx

Content-Encoding: gzip

Content-Type: text/html

Key Concept

If you remember nothing else from this pattern, remember: gzip_types controls which file types get compressed, and gzip_min_length avoids compressing tiny files that don't benefit.

Common Mistakes

Not enabling gzip with 'gzip on;' before setting gzip_types and gzip_min_length.

Without enabling gzip, the other settings have no effect and compression won't happen.

Always include 'gzip on;' in the http block before other gzip settings.

Setting gzip_min_length too low, like 1 byte.

Compressing very small files wastes CPU and can make files bigger due to compression overhead.

Set gzip_min_length to a reasonable size like 1000 bytes to compress only larger files.

Not including all needed MIME types in gzip_types, missing some file types.

Files of missing types won't be compressed, reducing performance benefits.

Include all common text-based MIME types your site uses, like text/css, application/javascript, and application/json.

Summary

Enable gzip compression in nginx with 'gzip on;'.

Use 'gzip_types' to specify which file types to compress.

Use 'gzip_min_length' to skip compressing very small files.

Test configuration syntax with 'nginx -t' before reloading.

Reload nginx to apply changes without downtime.