Skip to main content
You can use a CDN to deliver your site’s content to users more quickly. To set up a Fastly CDN with your own Fastly subscription, follow the instructions on this page.

​
Before you begin

You need:
  • An up-and-running Upsun project
  • A Fastly CDN subscription

​
1. Avoid double-caching

To avoid stale content that can’t be cleared, avoid using Fastly with HTTP caching. For routes where Fastly is used, disable HTTP caching using the following configuration:
.upsun/config.yaml
https://{default}/:
    type: upstream
    ...
    cache:
        enabled: false

​
2. Set up your Fastly CDN

To properly configure your Fastly CDN, see the Fastly official documentation on how to get started. Then set up a custom domain. To get the DNS challenge to succeed, have your CDN point to your project’s target URL.

​
3. Handle apex domains

To start routing client traffic through Fastly, create CNAME records for your domain names through your DNS provider. CNAME records can’t point to apex domains. As a workaround, Fastly offers Anycast options.

​
4. Optional: Protect your site from on-path attacks

An on-path attack occurs when a hacker intercepts or modifies the communication between a client and a server. This can lead to sensitive data leaks. To prevent such attacks, make sure all communication with your site is encrypted through HTTPS and can’t be downgraded to HTTP. To do so, enable HTTP strict transport security (HSTS). HSTS forces clients to always communicate with your site over HTTPS. You can enable HSTS in your Fastly account. All HTTP requests are then automatically redirected to HTTPS.
Last modified on March 11, 2026