Setting up redundant origin servers

Sometimes you want to set up two different origin servers, one as a primary and one as a backup in case the primary becomes unavailable. You can do this via the web interface or using custom VCL.


Each Fastly service can be configured with up to five origin servers. Contact to enable more than five origin servers per service in your account.

Using the web interface

Set up redundant origins via the web interface using these steps.

  1. Log in to the Fastly web interface.
  2. From the Home page, select the appropriate service. You can use the search box to search by ID, name, or domain. You can also go to CDN > CDN Services or Compute > Compute Services to access a list of services by type.
  3. Click Edit configuration and then select the option to clone the active version.
  4. Click Origins.
  5. In the Health Checks area, define a health check and assign it to the primary origin server.

  6. In the Hosts area, find your secondary origin server and click Attach a condition.

    an example secondary origin server

  7. Click Create a new request condition.

    an example create a new condition window

  8. Fill out the Create a new request condition fields as follows:

    • In the Name field, enter the name of your request condition (for example, Primary Unhealthy).
    • In the Apply if field, enter !req.backend.healthy.
  9. Click Save and apply to. The Hosts area now displays the condition that must be met (Primary Unhealthy) in order for your secondary origin server to begin being used.

    hosts condition primary unhealthy that will trigger use of the secondary origin server

    Once you've added the condition to your secondary origin server, the VCL generated by Fastly will reflect the new condition.

  10. Preview the VCL, and confirm the following snippets appear in vcl_recv:

    # default conditions
    set req.backend = F_primary;
    1# Request Condition: primary unhealthy Prio: 10
    2if (!req.backend.healthy) {
    3 set req.backend = F_secondary;
    5#end condition

Using custom VCL

Set up redundant origins with custom VCL using these steps.

  1. In the Fastly web interface, define a health check and assign it to the primary origin server.

  2. Copy the boilerplate VCL from our guide on mixing Fastly VCL with custom VCL, and paste it into a new file.

  3. Replace the vcl_recv sub with:

    1sub vcl_recv {
    2#FASTLY recv
    3 set req.backend = F_<primary_origin>;
    4 if (!req.backend.healthy) {
    5 set req.backend = F_<secondary_origin>;
    6 }
    7 if (req.method != "HEAD" && req.method != "GET" && req.method != "FASTLYPURGE") {
    8 return(pass);
    9 }
    10 return(lookup);

    To find the exact backend names, view the generated VCL.

  4. Upload your VCL file.

Was this guide helpful?

Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.