img-proxy

The image proxy feature allows redirecting image requests to a remote domain (typically production) through an Apache reverse proxy. This is useful for development environments where you want to use production images without downloading them locally.

How it works

When enabled, Apache intercepts image requests for wp-content/uploads and proxies them to the configured remote domain. Local files take precedence: if an image exists locally, it is served directly without proxying.

When using img-proxy, the dvs pull --files workflow can exclude wp-content/uploads so you avoid syncing large media directories.

Commands

Status

Display current image proxy configuration:

dvs img-proxy status

Shows:

• Current domain (if set)
• Image proxy mode (enabled/disabled)

Set domain

Configure the remote domain to proxy images from:

dvs img-proxy set-domain <domain>

Example:

dvs img-proxy set-domain mysite.example.com

If the proxy is already enabled, Apache will reload automatically after setting the domain.

Enable

Enable image proxy mode. Requires a domain to be set first:

dvs img-proxy enable

If no domain is configured, you will be prompted to set one using set-domain.

Disable

Disable image proxy mode:

dvs img-proxy disable

Toggle

Toggle image proxy mode on/off:

dvs img-proxy toggle

If enabling and no domain is set, you will be prompted to configure one first.

Usage example

# Check current status
dvs img-proxy status

# Configure remote domain
dvs img-proxy set-domain production.example.com

# Enable proxy
dvs img-proxy enable

# Later, disable it
dvs img-proxy disable

Technical details

• Apache is reloaded automatically when enabling/disabling or changing the domain
• The proxy targets wp-content/uploads on the remote domain
• Only image requests are proxied; local files are served normally