Get started

Creating an account

You’ll need an account before getting started. This only takes a few seconds!

Go the signup page and fill in your details in the web form. Click Register and you’re good to go.

Back To Top

Adding your website

  1. Log into the Warpcache control panel on my.warpcache.com.
  2. In the menu on the left click Vhosts.
  3. In the Vhost screen, you should see the New Vhost form. If not, press the blue Add new vhost button to open it.
  4. Fill in:
    • A label for your own cdn.warpcache.com CNAME
    • Your alias
      e.g. cdn.example.com
    • The location of your content in the Origin URL field
      The origin url needs to contain either http:// or https://
    • Add a path to a small file on your origin
      e.g. /robots.txt, we’ll monitor that file for you.
      You can also download a test file here, host it and use it as your test file.

Vhost creation

  1. Click the Create vhost button to finish.

Back To Top

Testing

To verify if setup was successful, you can:

  • Enter the following curl command in your terminal: curl -I <label>.cdn.warpcache.net/<monitoringfile>, or
  • Enter <label>.cdn.warpcache.net/<monitoringfile> in a page tester, such as Pingdom‘s.

 

Back To Top

Next steps

You can proceed to integrate using the cdn.warpcache.com host we provide you with, or first setup your own alias at your DNS provider.

Click here to view our integrations section, and here for a guide on how to set up your DNS.

Back To Top

Advanced

Setting up your DNS

The steps below are an approximation of how to use your DNS provider’s administration environment.

  1. Log into the administration environment of your DNS provider.
  2. Look for any menu or tab related to DNS (e.g. DNS zone editor, DNS settings, DNS manager).
  3. Search for the option to add an alias and CNAME.
  4. You can find your alias and CNAME in the Warpcache control panel:
    1. Log into your Warpcache account on my.warpcache.com.com.
    2. In the menu, click Vhosts, and click the website you want to find the CNAME of.
      The information field expands, and the CNAME should be listed above the alias.
    3. Copy the value listed below the CNAME heading, and your alias.
      Your CNAME will look like: <label.cdn>.warpcache.net
  5. Enter your alias and CNAME in the designated fields in the administration panel of your DNS provider.
  6. Save to create your DNS record.

It can take a while before changes in the DNS settings are processed by your hosting provider. To test whether your DNS record has propagated, check out our tips here.

In case you need assistance configuring your provider’s DNS records, consult your DNS provider. Alternatively, check out Google’s guides for most hosting providers here.

Back To Top

Purging via the Control Panel

To purge content using the Warpcache control panel, follow the steps below:

  1. Log into your account on my.warpcache.com.
  2. Click Purge in the menu on the left-hand side.
  3. Add the URLs you want to purge to the field.
  4. Click the Purge button to finish.

 

Back To Top

Integrations

Google Cloud Storage

Using GCS as your origin

Follow to steps below to configure Google Cloud Storage (GCS) as your origin within Warpache.

If you need help setting up your GCS bucket, click here for Google’s guides. Here are some tips about naming your bucket.

 

Step 1: Configure your GCS account

  1. Sign up for a GCS account and follow the basic setup.
  2. Create a bucket to hold the data.
  3. Add the files to your bucket and make them public.
    Tip: click the dots top right and select Edit object default permissions. Then, set user to allUsers and reader. This will make the whole bucket publicly readable.

public

Step 2: Create a Vhost in the Warpcache control panel

  1. Log into the Warpcache control panel on my.warpcache.com.
  2. In the menu on the left click Vhosts.
  3. In the Vhost screen, press the blue Create vhost button.
  4. Fill in:
    • A label for your Vhost
      e.g. <bucket name>
    • Your alias
      e.g. cdn.example.com
    • The location of your content in the Origin URL field
      e.g. https://storage.googleapis.com/<bucket name>/
    • Add a path to a small property in your bucket
      e.g. /image.png
  5. Click the Create vhost button to finish.

Back To Top

Amazon S3

Using Amazon S3 as your origin

To use your Amazon S3 bucket(s) as your origin, follow the steps below.

If you need help creating an S3 bucket, click here for Amazon’s guides.

 

Step 1: CREATE A VHOST IN THE WARPCACHE CONTROL PANEL

  1. Log into the Warpcache control panel on my.warpcache.com.
  2. In the menu on the left click Vhosts.
  3. In the Vhost screen, press the blue Create vhost button.
  4. Fill in:
    • A label for your Vhost
      e.g. <bucket name>
    • Your alias
      e.g. cdn.example.net
    • The location of your content in the Origin URL field
      e.g. https://<bucket name>.s3.amazonaws.com, or
      e.g. https://<bucket name>.<s3-region>.amazonaws.com
    • Add a path to a small property in your bucket
      e.g. /image.png
  5. Click the Create vhost button to finish.

Back To Top

WordPress

Before integrating with WordPress, you’ll need an alias – either use the one we provided you with in the control panel (<label>.cdn.warpcache.net), or the one you setup via your DNS provider (e.g. cdn.example.com).

 

Step 1: Installing the W3 Total Cache plugin

We’ll need to download and install the W3 Total Cache plugin.

  1. Sign in to your WordPress administration panel.
  2. In the menu on the left, select Plugins and click Add New.
  3. Top right, search for W3 Total Cache.
  4. Click the Install Now button.
  5. Once the installation is complete, press Activate.

The plugin can be used for free.

 

Step 2: Activate the plugin and set up CDNs

After activation, a new menu item will have been added on the left called Performance.

  1. Hit Performance and navigate to General Settings.
  2. Scroll down to the bottom of the page, to the CDN settings.
  3. Check the Enable CDN checkbox.
  4. Select Generic Mirror in the CDN Type drop-down menu.
  5. You should now see a red error box on the top of the page saying: ‘A configuration issue prevents CDN from working. The “Replace default hostname with” field cannot be empty. Specify it here.
  6. Click on Specify it here to configure host name. You will be directed to the CDN menu item under Performance.

Error

 

Step 3: Configuration

If you completed the quick-start guide, we have provided you with an alias (e.g. <label>.cdn.warpcache.net). Alternatively, you can use your own alias (e.g. cdn.example.net), retrieved via your hosting provider. To set up your own alias, follow this guide on setting up your DNS.

In this example we’ll use example.cdn.warpcache.nl. The alias can be found by clicking on your Vhost in the Warpcache control panel, under Vhost overview.

  1. Copy your CNAME from the Warpcache control panel, or use the custom alias you set up.

Vhost overview

  1. Switch back to WordPress and click the Performance tab, and then CDN.
  2. Scroll down to Configuration and paste your CNAME or alias in the field next to “Replace site’s hostname with:”.
  3. Click the Test Mirror button. If all went well you should get a green message saying that the test passed.

Test-mirror

  1. Hit Save all settings.

In case the test does not pass, try waiting a few minutes before testing again. If you just created your own alias it might take some time before the DNS has propagated. View our tips on testing your Vhost here.

From now on, WordPress will use Warpcache to serve out all the content on your website.

Back To Top

Magento

Before integrating with Magento, you must have completed our quick-start guide.

Step 1: Configuration

  1. Log into your Magento control panel
  2. Go to Configuration, under the System tab
  3. Click General in the menu on the left, then Web

Magento-config

If you intend to use HTTP proceed to Step 2, otherwise Step 3 for HTTPS.

 

Step 2: Setting up HTTP

  1. Click the Unsecure section in Web
  2. Enter the following information:
    • Base URL: your site URL
      e.g. http://www.example.com
    • Base Link URL: this field should be pre-populated with your Base URL
    • Base Skin URL: your CNAME or alias, followed by the skin folder
      e.g. http://<label>.cdn.warpcache.net/skin/ or http://cdn.example.com/skin/
    • Base Media URL: your CNAME or alias, followed by the media folder
      e.g. http://<label>.cdn.warpcache.net/media/ or http://cdn.example.com/media/
    • Base JavaScript URL: your CNAME or alias, followed by the JavaScript folder
      e.g. http://<label>.cdn.warpcache.net/js/ or http://cdn.example.com/js/

Note that in some cases JavaScript might not run if the CDN is not in your subdomain. Should this issue occur, change the Base JavaScript URL to your origin server.

Unsecure

  1. Click the orange Save Config button

Step 3: Setting up HTTPS

In order to use HTTPS, create a support ticket to enable SSL for your account – this feature is not yet available in our Control Panel.

  1. Click the Secure section in Web
  2.  Enter the following information:
    • Base URL: your site URL
      e.g. https://www.example.com
    • Base Link URL: this field should be pre-populated with your Base URL
    • Base Skin URL: your CNAME or alias, followed by the skin folder
      e.g. https://<label>.cdn.warpcache.net/skin/ or https://cdn.example.com/skin/
    • Base Media URL: your CNAME or alias, followed by the media folder
      e.g. https://<label>.cdn.warpcache.net/media/ or https://cdn.example.com/media/
    • Base JavaScript URL: your CNAME or alias, followed by the JavaScript folder
      e.g. https://<label>.cdn.warpcache.net/js/ or https://cdn.example.com/js/

Note that in some cases JavaScript might not run if the CDN is not in your subdomain. Should this issue occur, change the Base JavaScript URL to your origin server.

  1. Set Use Secure URL in Frontend to Yes
  2. Set Use Secure URL in Admin to Yes
  3. Don’t change Offloader header

Secure

  1. Click the orange Save Config button

Step 4: Testing

Verify whether the URL rewrite was successful by checking the HTML code of your site:

  1. Search for favicon.ico
  2. If the rewrite was successful, you will find <label>.cdn.warpcache.net/favicon.ico or cdn.example.com/favicon.ico in your HTML code

 

Back To Top

Support

Contact support

Select Support in the left-hand menu of the Control Panel, and fill in the fields to create a ticket.

Attachments can be added by clicking Attach a file.

Back To Top