EDGE-MODULES.md

Fastly Edge Modules

This guide will show how to configure Fastly Edge Modules. Fastly Edge Modules is a flexible framework that allows definition of UI components and associated VCL code through a template.

In order to enable Fastly Edge Modules you will need to turn them on by going to

Magento admin > Stores > Configuration > Advanced > System > Full Page Cache > Fastly Configuration > Advanced

Find Enable Fastly Edge Modules and select Yes then press Save Config at top right. After enabling you should now see Fastly Edge Module sub-menu like this

Click on Manage. Then Refresh button. A screen like this will be presented

You can now pick which modules you want to select. For example in this example I picked the CORS headers edge module

Now that you have selected which modules will be used you will need to go module by module and configure them individually. Make sure you click Upload once you done configuring individual modules.

Currently following Edge Modules are bundled in

• Blackfire integration - enable Fastly portion required for Blackfire profiling
• CORS headers - Set CORS headers sent to the end user
• Datadome bot detection integration - Datadome Bot Detection integration a filesystem URL to www.domain.com. Useful for redirecting apex/naked domains to www.
• Hard Reload Cache Bypass for admins - allows admin IPs to force cache bypass on browser hard reload. More details here
• Image Optimization Test Drive - view your site with a configurable image quality and see what the savings could be in real time. Helps answer the question "What image quality level should I set".
• Increase timeouts for long running jobs - Tweak timeouts for jobs/URLs that take longer than 1 minute
• Integrate other CMS/backend - configures integration of specific URLs to integrate other CMSes/backends into your Magento shop
• Mobile Theme Support - module required for supporting mobile device themes
• Netacea bot detection integration - Netacea Bot Detection integration
• Redirect one domain to another - redirect one domain to another e.g. domain.com
• URL rewrites - rewrite incoming /sitemap.xml URL to

Updating Edge Modules

You may update the enabled Edge Modules when they got updated in a new Fastly Magento module release. To do so, please follow the below steps:

1. Ensure your installed Fastly Magento module is the most up-to-date version
2. Click the Manage button in the Fastly Edge Modules section
3. Click Refresh and Save buttons on right-top
4. Click the gear button of each edge module and re-update them one by one