The NetStorage origin server

You can follow each of the sections in this workflow to add ​Akamai​ NetStorage as your origin server in your property.

Before you begin

This is optional, but it's recommended. Take a minute to familiarize yourself with the flow of a request involving the ​Akamai​ network.

1. Prepare your edge certificate

The first phase of a request flow involves the end user contacting ​Akamai​ edge servers. To secure this connection with HTTPS, you'll need to prepare your edge certificate.


If you need to use the custom certificate method, you'll need to wait until it completes provisioning before you continue. You'll receive an email once it's ready.

2. Meet some prerequisites

Before you can use NetStorage as your origin, you need to get it added to your contract and set it up. Once completed, you'll have two values you need for this process:

  • Your Storage Group Name
  • A Content Provider (CP) code for your Upload Directory

3. Set up your property

If you haven't yet, perform these operations to initially set up your property in Property Manager:

  1. Create a brand new property
  2. Define a secure property hostname (for delivery via HTTPS)
  3. Define property variables (optional)

4. Set up the Origin Server behavior

Now, let's apply some settings in the Property Configuration Settings to set up NetStorage as the origin. We're using the Origin Server behavior in the Default Rule so that NetStorage is the origin for all requests.

  1. Find the Origin Server behavior in the Default Rule.

  2. Set Origin Type to NetStorage.

  3. Click NetStorage Account and select the appropriate storage group based on the values you noted when you created the storage group:

    • The Storage Group Name.
    • The CP Code assigned to the Upload Directory

5. Apply caching settings

With NetStorage selected as your origin, there are some caching-related settings that you should apply for best performance. These vary based on the product in use.


Apply these settings in the same rule that you've set NetStorage as your Origin Server.

Product Settings

Adaptive Media Delivery

An error message appears in the Origin Server behavior when you select NetStorage.

  • You can't use Cache Key Query Parameters. NetStorage doesn't honor query strings. The Cache Key Query Parameters behavior is added by default to the Default Rule. Ensure it's set to Exclude all parameters. This will avoid duplicate cache keys for the same object.

  • Add Cache HTTP Error Responses as an optional behavior. With Cache Key Query Parameters in your propertyregardless of its settinga warning message is shown, that prompts you to set the Max-age option in the Cache HTTP Error Responses behavior to 30.

Download Delivery

Same as Adaptive Media Delivery.


An error message appears in the Origin Server behavior when you select NetStorage.

  • Caching can't be set to "No store". The Offload origin child rule includes the Caching behavior, set to No store by default. NetStorage doesn't support this or the Bypass cache optionsyou need to apply some form of caching. Set it to any of the other options available with this behavior, that best suits your need.

  • Set the appropriate Caching "maxage". Along with changing the Caching behavior to another Caching option, you should set the Maxage setting to at least 10 minutes. This allows NetStorage adequate time to index and access your content, in the event of a change to it. File modifications are immediately reflected only on the upload server, while replication to other NetStorage servers in different locations may take a few minutes.

  • You can't use Cache Key Query Parameters. When setting up the Offload origin rule you need to set the Cache Key Query Parameters behavior to Exclude all parameters. NetStorage doesn't honor query strings, so you should set this to avoid duplicate cache keys for the same object.

  • Add the Cache HTTP error responses. Enable it and set it to 30 seconds. This allows NetStorage optimal time to address and log errors.

  • Set the HTML pages sub-rule to support NetStorage. This sub-rule is preconfigured to optimize delivery from custom or third-party origin servers, not NetStorage. You'll need to update its settings to enable caching with a Maxage of at least 10 minutes, and exclude cache key query parameters.

  • Disable SureRoute. NetStorage requires some form of caching, and SureRoute is only supported for use with No Store (non-cached) content. For best performance, disable it by setting the behavior's Enable slider to Off.

  • Remove Chase Redirects. Chase Redirects are automatically enabled for NetStorage to support its replication infrastructure. To avoid conflicts, remove this behavior from the Offload origin rule by clicking Remove behavior ().

Object Delivery

Same as Adaptive Media Delivery.

However, the Cache Key Query Parameters behavior isn't included by default. Add it to your Default Rule and set it to Exclude all parameters.


Are you using Ion?

An Ion property contains specific rules that you can configure to optimize end-user access and use of your origin server: