How to setup Concrete CMS behind CDN (Amazon CloudFront)

This is a community-contributed tutorial. This tutorial is over a year old and may not apply to your version of Concrete CMS.
Jul 16, 2016
By hissy for Developers

Issues

The main issue of using Concrete CMS behind CDN is host names.

  • www.example.com
    • CDN (Amazon CloudFront)
    • When guest users access to your site, visit to this host.
  • origin.example.com
    • Origin Web server (concrete5)
    • When you login to concrete5, access to this host. |

When this case, concrete5's canonical URL is origin.example.com, but actual host name for gust users is www.example.com .

The sub issue is cache life time.

CDN stores cache only when the full page cache is enabled, because of Cache-Control header. However, full page cache should be disabled when editing content with concrete because of host name.

How can we solve the issues?

  1. When editing content on origin.example.com, turn off caching.
  2. When viewing content on www.example.com, turn on caching and set www.example.com to canonical URL.

Code

1. Change environment to cdn when HTTP User Agent is 'Amazon CloudFront'.

application/bootstrap/start.php

<?php
use Concrete\Core\Application\Application;

/**
 * -----------------------------------------------------------------
 * Instantiate concrete5
 * -----------------------------------------------------------------
 */
$app = new Application();

/**
 * -----------------------------------------------------------------
 * Detect the environment based on the use agent
 * -----------------------------------------------------------------
 */
$app->detectEnvironment(function(){
    $request = \Concrete\Core\Http\Request::getInstance();
    if ($request->server->get('HTTP_USER_AGENT') == 'Amazon CloudFront') {
        return 'cdn';
    }
});

return $app;

2. Turn off caching on default environment

application/config/concrete.php

<?php

return array(
    'cache' => array(
        'blocks' => false, // turn off block cache
        'pages' => 0, // turn off page cache
    ),
);

3. Turn on caching on cdn environment, and set canonical URLs

application/config/cdn.concrete.php

<?php

return array(
    'cache' => array(
        'blocks' => true, // turn on block cache
        'pages' => 'blocks', // cache page if all blocks support it.
    ),
    'seo' => array(
        'canonical_url' => 'http://www.example.com/',
        'canonical_ssl_url' => 'https://www.example.com/',
    ),
);
Recent Tutorials
Edit domains and sitemaps
Apr 4, 2025
By myq.

How to create a sitemap when using an edit domain

Block Types and CIF Data
Apr 2, 2025
By mlocati.

This tutorial describes how Concrete works with blocks data, and how you can create custom block types that works well when exporting and importing data with the CIF XML format.

Customize the default page title
Mar 12, 2025

Change the default " :: " and/or "site name :: page title" formatting separator to something else.

Configure Composer to work with a Page Type
Feb 20, 2025
By myq.

Fix the "Unable to load block into composer. You must edit this content from within the context of the page." error message

Permissions for editors in a multilingual site
Feb 2, 2025
By myq.

How to set up a multilingual Concrete CMS site for groups of language-specific editors

Restoring deleted pages using advanced search
Jan 16, 2025
By myq.

How to recover deleted pages when there are more than a few to choose from.

Improvements?

Let us know by posting here.