Using Remote Files when Developing Locally with Stage File Proxy Module

20th November 2014

Download the Stage File Proxy module from and enable it on your 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'] = '';

// 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:[email protected]';

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

About the Author

Picture of Oliver

Oliver Davies is a Web Developer, System Administrator and Drupal specialist based in the UK. He is a Senior Developer at Microserve and also provides freelance consultancy services for Drupal, Symfony and Laravel applications and Linux servers.


  • Currently no spare part-time capacity.
  • Currently no spare full-time capacity.