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.

Practice

1. What does the gzip_types directive do in an nginx configuration?

easy

A. Defines the compression level for gzip

B. Specifies which MIME types should be compressed using gzip

C. Enables or disables gzip compression globally

D. Sets the minimum file size for gzip compression

Solution

1. Step 1: Understand the purpose of gzip_types

   The gzip_types directive tells nginx which file types (MIME types) to compress when gzip is enabled.

2. Step 2: Differentiate from other gzip directives

   gzip_min_length sets minimum size, gzip enables compression, and compression level is set by gzip_comp_level. So gzip_types is about file types.

3. Final Answer:

   Specifies which MIME types should be compressed using gzip -> Option B

4. Quick Check:

   gzip_types = file types to compress [OK]

Hint: gzip_types controls file types compressed, not size or enable [OK]

Common Mistakes:

• Confusing gzip_types with gzip_min_length
• Thinking gzip_types enables gzip globally
• Mixing gzip_types with compression level settings

2. Which of the following is the correct syntax to set gzip minimum length to 1000 bytes in nginx?

easy

A. gzip_min_length = 1000;

B. gzip_minlength 1000;

C. gzip_min_length 1000;

D. gzip_min_length: 1000;

Solution

1. Step 1: Recall nginx directive syntax

   nginx directives use the format directive_name value; without equals or colons.

2. Step 2: Check spelling and punctuation

   The correct directive is gzip_min_length with underscore, no equals sign, and ends with semicolon.

3. Final Answer:

   gzip_min_length 1000; -> Option C

4. Quick Check:

   Correct syntax = gzip_min_length 1000; [OK]

Hint: Use underscore and semicolon, no equals or colon [OK]

Common Mistakes:

• Using equals sign (=) in directive
• Misspelling gzip_min_length as gzip_minlength
• Using colon (:) instead of semicolon

3. Given this nginx config snippet:

gzip on;
gzip_types text/plain application/json;
gzip_min_length 1000;

What happens when a 500-byte JSON response is sent?

medium

A. The JSON response is sent uncompressed

B. The JSON response is compressed with gzip

C. The server returns an error due to size

D. The JSON response is compressed only if client supports gzip

Solution

1. Step 1: Check gzip_min_length effect

   The gzip_min_length 1000; means only responses larger than 1000 bytes get compressed.

2. Step 2: Compare response size and type

   The JSON response is 500 bytes, less than 1000, so it will not be compressed despite matching type.

3. Final Answer:

   The JSON response is sent uncompressed -> Option A

4. Quick Check:

   Response size < gzip_min_length = no compression [OK]

Hint: Check response size against gzip_min_length first [OK]

Common Mistakes:

• Assuming all gzip_types are compressed regardless of size
• Ignoring gzip_min_length setting
• Confusing client support with server compression decision

4. You have this nginx config:

gzip on;
gzip_types text/html text/css;
gzip_min_length 512

Why might gzip not compress CSS files as expected?

medium

A. gzip is disabled by default

B. gzip_types does not include CSS MIME type

C. gzip_min_length value is too high

D. Missing semicolon after gzip_min_length directive

Solution

1. Step 1: Check syntax of gzip_min_length

   The directive gzip_min_length 512 is missing a semicolon at the end, causing nginx to ignore or error on it.

2. Step 2: Understand effect of syntax error

   Without proper syntax, gzip_min_length may not apply correctly, causing unexpected behavior in compression.

3. Final Answer:

   Missing semicolon after gzip_min_length directive -> Option D

4. Quick Check:

   Every directive must end with semicolon [OK]

Hint: Always end nginx directives with semicolon [OK]

Common Mistakes:

• Forgetting semicolon at directive end
• Assuming gzip_types excludes CSS by default
• Thinking gzip is off unless explicitly enabled

5. You want to compress only JSON and JavaScript files larger than 1500 bytes using gzip in nginx. Which configuration snippet achieves this correctly?

hard

A. gzip on;\ngzip_types application/json application/javascript;\ngzip_min_length 1500;

B. gzip on;\ngzip_types json js;\ngzip_min_length 1500;

C. gzip on;\ngzip_types application/json application/javascript;\ngzip_min_length 1500

D. gzip on;\ngzip_types application/json application/javascript;\ngzip_min_length=1500;

Solution

1. Step 1: Verify gzip is enabled

   The directive gzip on; correctly enables gzip compression.

2. Step 2: Check gzip_types values

   Use correct MIME types: application/json and application/javascript are valid. Short forms like 'json' or 'js' are invalid.

3. Step 3: Confirm gzip_min_length syntax

   The directive must end with semicolon and no equals sign. gzip_min_length 1500; is correct.

4. Final Answer:

   gzip on;\ngzip_types application/json application/javascript;\ngzip_min_length 1500; -> Option A

5. Quick Check:

   Correct MIME types + syntax + min_length = gzip on;\ngzip_types application/json application/javascript;\ngzip_min_length 1500; [OK]

Hint: Use full MIME types and end directives with semicolon [OK]

Common Mistakes:

• Using shorthand MIME types like 'json' or 'js'
• Omitting semicolon at directive end
• Using equals sign in directives