Adobe Commerce Fastly troubleshooter

Last update: Wed Dec 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

This Fastly troubleshooter for Adobe Commerce users will guide you to the solutions, based on your response about the symptoms you see.

Description description

Environment

Adobe Commerce on Cloud Infrastructure

Issue/Symptoms

Fastly service is down
VCL version is outdated
Image optimization error
DNS configuration error
Certificate error
TLS certificate expired

Resolution resolution

Click on each question to reveal the answer details in each step of the troubleshooter.

Step 1- Verify Fastly service

Customer reports a problem involving Fastly. Is the Fastly service down?

a. YES - Check Fastly Service Status, and submit an Adobe Commerce support ticket.
b. NO - Proceed to Step 2.

Step 2- Check VCL configuration file

Do you have any errors when you run Backend Tester?

Run your project URL through the Backend Tester - Fastly. It shows the version of VCL configuration file, if the page is cacheable, the version of Fastly module and other useful troubleshooting information. Do you have any errors?

a. YES – You have the message Plugin VCL version is outdated! Please re-Upload. For the solution to this error, refer to Fastly Error: Plugin VCL version is outdated! Please re-Upload.
NO - Proceed to Step 3.

Step 3- Check for image optimization error

Image optimization error?

a. YES – Error when enabling image optimization.
b. NO – Check DNS by running in the CLI/terminal: dig [ your website.com] + short. Proceed to Step 4.

Step 4- Verify DNS

What happens when you run dig?

When you ran dig did it return a record pointing to prod.magentocloud.map.fastly.net or one of the following IP addresses (see Update DNS configuration with production setting in our developer documentation):

151.101.1.124
151.101.65.124
151.101.129.124
151.101.193.124
a. YES – The issue is not DNS related. Proceed to Step 5.
b. NO – The issue is likely DNS related. The customer should check DNS configuration or contact their DNS provider for more information.

Step 5- Confirm connection

Do you get a "Connection Insecure" or "Not Secure" message returned when running curl -svo /dev/null "https://website.com" in the CLI/terminal?

a. YES – This is likely a certificate issue. Visit the website in a browser and select the lock icon and look for a certificate expiration. Proceed to Step 6.
b. NO – Visit http://fastly-debug.com and share this information in an Adobe Commerce support ticket.

Step 6- Confirm you have a valid TSL certificate

Is the certificate expired?

a. YES – You need to renew your TLS certificate with the Certificate Authority (CA).
b. NO – You may not have a certificate at all. If you have Adobe Commerce we recommend that you purchase a TLS certificate. If you are on Adobe Commerce on cloud infrastructure you can have a Domain-Validated Let’s Encrypt SSL/TLS certificate to serve secure HTTPS traffic from Fastly. See provision SSL/TLS certificates in our developer documentation.

Back to Step 1

recommendation-more-help

3d58f420-19b5-47a0-a122-5c9dab55ec7f