Using Remote Files when Developing Locally with Stage File Proxy Module

20th November 2014

Warning: This post is over a year old. I don't always update old posts with new information, so some of this information may be out of date.

How to install and configure the Stage File Proxy module to serve remote images on your local Drupal site.

As this module is only going to be needed on pre-production sites, it would be better to configure this within your settings.php or settings.local.php file. We do this using the $conf array which removes the need to configure the module through the UI and store the values in the database.

// File proxy to the live site.
$conf['stage_file_proxy_origin'] = 'http://www.example.com';

// Don't copy the files, just link to them.
$conf['stage_file_proxy_hotlink'] = TRUE;

// Image style images are the wrong size otherwise.
$conf['stage_file_proxy_use_imagecache_root'] = FALSE;

If the origin site is not publicly accessible yet, maybe it's a pre-live or staging site, and protected with a basic access authentication, you can include the username and password within the origin URL.

$conf['stage_file_proxy_origin'] = 'http://user:password@prelive.example.com';

Questions? Comments? I’m @opdavies on Twitter.

Tags: drupal, drupal-planet, servers

About the Author

Picture of Oliver

Oliver Davies is a full-stack Web Developer and System Administrator based in the UK. He is a Senior Developer at Microserve and a part-time freelancer specialising in Drupal, Symfony and Laravel development and Linux systems administration.