{"id":4323,"date":"2026-09-12T15:50:55","date_gmt":"2026-09-12T10:20:55","guid":{"rendered":"https:\/\/cpanelfree.com\/blog\/how-to-configure-brotli-compression-nginx-apache\/"},"modified":"2026-09-12T15:52:24","modified_gmt":"2026-09-12T10:22:24","slug":"how-to-configure-brotli-compression-nginx-apache","status":"publish","type":"post","link":"https:\/\/cpanelfree.com\/blog\/how-to-configure-brotli-compression-nginx-apache\/","title":{"rendered":"How to Configure Brotli Compression in Nginx & Apache (Better than Gzip)"},"content":{"rendered":"
\n Quick Technical Answer:<\/strong><\/p>\n

\n To activate Brotli compression<\/strong> on Ubuntu Nginx: Install the official Google Brotli module with sudo apt install -y libnginx-mod-brotli<\/code>. Inside your http {}<\/code> block in \/etc\/nginx\/nginx.conf<\/code>, add brotli on;<\/code>, brotli_comp_level 6;<\/code>, brotli_static on;<\/code>, and declare text MIME types using brotli_types text\/plain text\/css application\/javascript application\/json image\/svg+xml;<\/code>. Test live activation with curl -I -H \"Accept-Encoding: br\" https:\/\/yourdomain.com<\/code>; the server will return content-encoding: br<\/code>.\n <\/p>\n<\/div>\n

Why Gzip Is Being Replaced by Google Brotli Across the Modern Web<\/h2>\n

For over twenty-five years, Gzip (Deflate)<\/strong> served as the standard algorithm for compressing web assets in flight. While reliable, Gzip compresses each file in isolation using dynamic Huffman trees with no historical knowledge of common web development syntax.<\/p>\n

Developed by Google software engineers, Brotli (RFC 7932)<\/strong> was designed specifically for web payloads (HTML, CSS, JavaScript, SVG, and JSON). Brotli’s breakthrough innovation is its built-in, uncompressed 120KB static dictionary<\/strong> containing over 13,000 common web phrases, HTML tags, CSS properties, and JavaScript keywords.<\/p>\n

Because the web browser and the server already share this dictionary in memory, when Nginx encounters <div class=\"container\"><\/code> or document.getElementById<\/code>, it does not need to compress the characters\u2014it simply transmits a tiny numeric pointer. In real-world production deployments, Brotli delivers 20% to 30% smaller file sizes than Gzip<\/strong> at identical compression speeds.<\/p>\n

Step 1: Installing the Google Brotli Module for Nginx on Ubuntu<\/h2>\n

Modern Ubuntu distributions (22.04 LTS and 24.04 LTS) provide pre-compiled dynamic Brotli modules directly in official repositories:<\/p>\n

# Install Nginx Brotli dynamic module\nsudo apt update && sudo apt install -y libnginx-mod-brotli\n\n# Verify dynamic module files are present\nls -la \/usr\/share\/nginx\/modules-available\/mod-brotli.conf<\/code><\/pre>\n
Step 2: Configuring Brotli in \/etc\/nginx\/nginx.conf<\/h2>\n
Open your main Nginx configuration file:<\/p>\n
sudo nano \/etc\/nginx\/nginx.conf<\/code><\/pre>\n
Insert the optimized Brotli directives inside the http { ... }<\/code> context, alongside or replacing Gzip:<\/p>\n
http {\n    # Ensure Gzip remains active as a fallback for legacy clients\n    gzip on;\n    gzip_comp_level 5;\n    gzip_types text\/plain text\/css application\/javascript application\/json image\/svg+xml;\n\n    # ==========================================\n    # Google Brotli Compression Configuration\n    # ==========================================\n    brotli on;\n    \n    # Static Pre-Compressed Asset Serving (.br files on disk)\n    brotli_static on;\n    \n    # Dynamic Compression Level (1 = Fastest, 11 = Smallest)\n    # Level 5 or 6 provides optimal balance between CPU utilization and file size\n    brotli_comp_level 6;\n    \n    # Minimum response size to trigger compression (skip tiny <256 byte headers)\n    brotli_min_length 256;\n    \n    # MIME Types to Compress\n    brotli_types\n        text\/plain\n        text\/css\n        text\/xml\n        text\/javascript\n        application\/javascript\n        application\/x-javascript\n        application\/json\n        application\/xml\n        application\/xml+rss\n        application\/atom+xml\n        image\/svg+xml\n        font\/otf\n        font\/ttf\n        font\/woff\n        font\/woff2;\n}<\/code><\/pre>\n
Step 3: Validating Syntax & Reloading Nginx<\/h2>\n
Verify your Nginx configuration syntax and reload the daemon:<\/p>\n
# Test syntax\nsudo nginx -t\n\n# Gracefully reload Nginx without dropping connections\nsudo systemctl reload nginx<\/code><\/pre>\n
Step 4: Real-World Benchmark: Brotli vs Gzip Compression Ratios<\/h2>\n\n\n\n\n\n\n\n
Asset Type \/ Library<\/th>\nOriginal Raw Size<\/th>\nGzip Level 6<\/th>\nBrotli Level 6<\/th>\nBandwidth Saved<\/th>\n<\/tr>\n<\/thead>\n
Tailwind CSS (Production)<\/strong><\/td>\n142 KB<\/td>\n28.4 KB<\/td>\n21.1 KB<\/strong><\/td>\n-25.7%<\/strong><\/td>\n<\/tr>\n
React + ReactDOM Bundle<\/strong><\/td>\n154 KB<\/td>\n49.2 KB<\/td>\n39.8 KB<\/strong><\/td>\n-19.1%<\/strong><\/td>\n<\/tr>\n
JSON REST API Payload<\/strong><\/td>\n850 KB<\/td>\n98.5 KB<\/td>\n68.2 KB<\/strong><\/td>\n-30.7%<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Step 5: How to Configure Brotli in Apache (mod_brotli)<\/h2>\n
If your web server runs Apache, enabling Brotli is equally straightforward using the native mod_brotli<\/code> module:<\/p>\n
# Enable Apache Brotli module\nsudo a2enmod brotli\n\n# Configure Brotli compression filter in \/etc\/apache2\/mods-available\/brotli.conf\nsudo nano \/etc\/apache2\/mods-available\/brotli.conf<\/code><\/pre>\n
Insert the filter directives:<\/p>\n
<IfModule mod_brotli.c>\n    AddOutputFilterByType BROTLI_COMPRESS text\/html text\/plain text\/xml text\/css text\/javascript application\/javascript application\/json image\/svg+xml\n    BrotliCompressionQuality 6\n<\/IfModule><\/code><\/pre>\n
Restart Apache to apply: sudo systemctl restart apache2<\/code>.<\/p>\n
Pro Sysadmin Tip: Static Pre-Compression for Build Pipelines<\/h2>\n
When running Vite, Next.js, or Webpack build pipelines, generate pre-compressed .br<\/code> files at Brotli Quality 11<\/strong> (maximum compression) during your CI\/CD build. Because brotli_static on;<\/code> is configured, Nginx will serve these pre-built .br<\/code> files directly from disk with zero runtime CPU overhead<\/strong>!<\/p>\n
Frequently Asked Questions (FAQ)<\/h2>\n
\n
Do all modern web browsers support Brotli?<\/h3>\n
Yes. Over 98% of all global web traffic (Google Chrome, Safari, Firefox, Edge, and mobile browsers) natively sends Accept-Encoding: gzip, deflate, br<\/code>. If an ancient browser does not support Brotli, Nginx automatically serves standard Gzip.<\/p>\n
Should I compress images (JPEG, PNG, WebP) with Brotli?<\/h3>\n
No! Formats like JPEG, PNG, WebP, and AVIF are already heavily compressed binary files. Attempting to compress them with Brotli or Gzip wastes significant CPU cycles and can actually increase the resulting file size.<\/p>\n<\/div>\n
\n
\ud83d\udd17 Recommended Related Technical Guides<\/h3>\n