Stage File Proxy is a general solution for getting production files on a development server on demand. It saves you time and disk space by sending requests to your development environment's files directory to the production environment and making a copy of the production file in your development site. You should not need to enable this module in production.

Difference in branches

2.1.x is dedicated for Drupal 10 and php8
2.0.x is dedicated for Drupal 10 and 9.

More details on the features/benefits

When developing Drupal sites locally, you often face a choice between broken images and taking the time to copy a snapshot of the remote files directory, which might be several gigabytes large, depending on the site. Stage File Proxy lets you update the database of your local development instance without having to update your files directory. Stage File Proxy transfers each requested file just in time when it is requested. This is especially useful for large sites with huge numbers of files. If you only visit 2 pages and only need 10 remote files to serve those pages, Stage File Proxy will only transfer those 10 files. Stage File Proxy has an additional mode in which it can serve a 301 redirect to files on the server, so it's possible to see all your images without having a local files directory at all.

Simple install and configuration for Drupal 7

If you have drush installed already then installing and configuring this module can be as easy as:

drush pm-download stage_file_proxy
drush pm-enable --yes stage_file_proxy
drush variable-set stage_file_proxy_origin "https://www.example.com"

Simple install and configuration for Drupal 8

It is recommended to use Composer to install the module and you can use Drush to configure it:

composer require drupal/stage_file_proxy
drush en stage_file_proxy
drush config-set stage_file_proxy.settings origin "https://www.example.com"

Of course, replace example.com with your live site.

Warning: If you use Drupal Core 8.7.6 or below then the latest releases of Stage File Proxy will break your site. You should pin your site to use Stage File Proxy version 8.x-1.0-beta1 or upgrade core.

Imagecache/Image Style support

Stage File Proxy integrates with imagecache to transfer the original image from the origin and then resize it locally.

Platform support and installation

This module has been tested using Apache 2 on Mac OS X and Linux.

For more information, see the installation instructions 7.x or 8.x.

Development-focused module

This module is for making it easier to manage local development environments or test-servers that are separated from the vast, malicious internet at the network level. You should not install this module on a server that faces the internet. If you do, you should audit the code thoroughly before doing so. As the introduction says:

You should not need to enable this module in production.

Supporting organizations: 
Maintenance and support
Maintenance and support
Maintenance and support

Project information

Releases