Open file cache in Nginx - Commands & Configuration

Introduction

When a web server reads files repeatedly, it can slow down if it opens the same files over and over. Open file cache helps by keeping file information ready in memory, so the server can access files faster without reopening them each time.

When your website serves many static files like images or stylesheets and you want faster loading times.

When your server handles many requests for the same files and you want to reduce disk access.

When you want to improve performance without changing your hardware.

When you notice slow response times due to frequent file opening operations.

When you want to reduce the load on your storage system by caching file metadata.

Config File - nginx.conf

nginx.conf

http {
    open_file_cache max=1000 inactive=20s;
    open_file_cache_valid 30s;
    open_file_cache_min_uses 2;
    open_file_cache_errors on;

    server {
        listen 80;
        server_name example.com;

        location / {
            root /var/www/html;
            index index.html;
        }
    }
}

open_file_cache sets the maximum number of cached files and how long inactive entries stay cached.

open_file_cache_valid defines how often the cache is refreshed.

open_file_cache_min_uses sets the minimum number of times a file must be accessed to be cached.

open_file_cache_errors enables caching of file errors like "file not found" to avoid repeated disk checks.

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 configuration without stopping the server.

Terminal

sudo systemctl reload nginx

Expected Output

No output (command runs silently)

Send a request to the server to verify it serves files correctly with the new cache settings.

Terminal

curl -I http://localhost/index.html

Expected Output

HTTP/1.1 200 OK

Server: nginx

Date: Wed, 01 Jan 2025 12:00:00 GMT

Content-Type: text/html

Content-Length: 612

Last-Modified: Tue, 31 Dec 2024 10:00:00 GMT

Connection: keep-alive

ETag: "5e2a-5c3a5f8b4a000"

Accept-Ranges: bytes

Key Concept

If you remember nothing else from this pattern, remember: open file cache keeps file info ready in memory to speed up repeated file access and reduce disk load.

Common Mistakes

Setting open_file_cache max value too low or too high without testing.

Too low means not enough files are cached, so performance gains are minimal; too high wastes memory and can cause instability.

Start with a moderate max value like 1000 and adjust based on server memory and workload.

Not reloading nginx after changing the configuration.

Changes won't take effect until nginx reloads, so caching won't work as expected.

Always run 'sudo nginx -t' to check config, then 'sudo systemctl reload nginx' to apply changes.

Ignoring caching of file errors by leaving open_file_cache_errors off.

Repeatedly checking for missing files wastes resources and slows down the server.

Enable open_file_cache_errors on to cache file errors and reduce unnecessary disk checks.

Summary

Configure open_file_cache in nginx.conf to cache file metadata and improve performance.

Test the configuration syntax with 'nginx -t' before applying changes.

Reload nginx to apply the new cache settings without downtime.

Verify the server serves files correctly after enabling open file cache.

Practice

1. What is the main purpose of the open_file_cache directive in nginx?

easy

A. To limit the number of open connections to clients

B. To store file information in memory to speed up file access

C. To cache HTTP responses from upstream servers

D. To compress files before sending them to clients

Solution

1. Step 1: Understand the role of open_file_cache

   The open_file_cache directive caches file metadata like file descriptors and attributes.

2. Step 2: Identify its effect on performance

   By caching file info, nginx reduces disk access and speeds up serving static files.

3. Final Answer:

   To store file information in memory to speed up file access -> Option B

4. Quick Check:

   open_file_cache purpose = cache file info [OK]

Hint: Remember: open_file_cache speeds file access by caching file info [OK]

Common Mistakes:

• Confusing open_file_cache with HTTP response caching
• Thinking it limits client connections
• Assuming it compresses files

2. Which of the following is the correct syntax to enable open file cache with 1000 max cached files and 60 seconds inactive timeout?

easy

A. open_file_cache max=1000 inactive=60;

B. open_file_cache 1000 60s;

C. open_file_cache max=1000 inactive=60s;

D. open_file_cache max=1000 inactive=60sec;

Solution

1. Step 1: Recall correct open_file_cache syntax

   The syntax requires named parameters like max= and inactive= with time units.

2. Step 2: Check each option for correctness

   open_file_cache max=1000 inactive=60s; uses correct parameter names and time unit s for seconds.

3. Final Answer:

   open_file_cache max=1000 inactive=60s; -> Option C

4. Quick Check:

   Use named params with units for open_file_cache [OK]

Hint: Use named parameters with units like 'inactive=60s' [OK]

Common Mistakes:

• Omitting parameter names
• Missing time units for inactive
• Using incorrect time unit abbreviations

3. Given this nginx config snippet:

open_file_cache max=2 inactive=30s;
open_file_cache_valid 10s;

What happens when nginx tries to serve 3 different files within 10 seconds?

medium

A. All 3 files are cached because open_file_cache_valid is 10s

B. All files are cached but expire after 30 seconds

C. No files are cached because max is less than 3

D. Only 2 files are cached; the third file info is not cached

Solution

1. Step 1: Understand max parameter effect

   The max=2 limits cache to 2 file entries only.

2. Step 2: Analyze caching of 3 files

   When 3 files are requested, only 2 can be cached; the third is not cached.

3. Final Answer:

   Only 2 files are cached; the third file info is not cached -> Option D

4. Quick Check:

   max=2 limits cache size to 2 files [OK]

Hint: max limits cached files count; extras are not cached [OK]

Common Mistakes:

• Assuming all files cache regardless of max
• Confusing open_file_cache_valid with max
• Thinking inactive controls cache size

4. You configured open_file_cache max=100 inactive=60s; but notice no caching effect. What is a likely cause?

medium

A. You forgot to enable open_file_cache_valid directive

B. The max value is too high to cache files

C. The inactive time is too short to cache files

D. open_file_cache only works with dynamic content

Solution

1. Step 1: Check required directives for caching

   Besides open_file_cache, open_file_cache_valid must be set to define cache validity.

2. Step 2: Identify missing directive effect

   Without open_file_cache_valid, cached entries expire immediately, so no caching effect.

3. Final Answer:

   You forgot to enable open_file_cache_valid directive -> Option A

4. Quick Check:

   open_file_cache_valid enables cache duration [OK]

Hint: Always set open_file_cache_valid to activate caching [OK]

Common Mistakes:

• Ignoring open_file_cache_valid directive
• Misunderstanding max and inactive roles
• Thinking open_file_cache works only for dynamic content

5. You want to optimize nginx for a high-traffic static site. Which open_file_cache settings best improve performance while avoiding stale data?

hard

A. open_file_cache max=1000 inactive=60s; open_file_cache_valid 30s;

B. open_file_cache max=10 inactive=300s; open_file_cache_valid 300s;

C. open_file_cache max=5000 inactive=5s; open_file_cache_valid 1s;

D. open_file_cache max=100 inactive=3600s; open_file_cache_valid 3600s;

Solution

1. Step 1: Balance cache size and freshness

   High-traffic static sites benefit from a large cache (max=1000) and moderate inactive timeout (60s) to keep data fresh.

2. Step 2: Set cache validity to avoid stale data

   open_file_cache_valid 30s ensures cached info refreshes often enough to prevent stale data.

3. Final Answer:

   open_file_cache max=1000 inactive=60s; open_file_cache_valid 30s; -> Option A

4. Quick Check:

   Large max + moderate inactive + short valid = best performance [OK]

Hint: Use large max, moderate inactive, short valid for fresh cache [OK]

Common Mistakes:

• Setting max too low for traffic
• Using too long inactive or valid causing stale cache
• Setting valid too short causing overhead