mirror of
https://github.com/imgproxy/imgproxy.git
synced 2025-01-23 11:14:48 +02:00
c51521961f
* Update landing page / README.md * Update GETTING_STARTED.md * Update installation.md * Update getting_the_image_info.md * update signing_the_url.md * Update watermark.md * Update presets.md * Update object_detection.md * Update autoquality.md * Update serving_local_files.md * Update docs/serving_files_from_s3.md * Update configuration.md * Update generating_the_url.md * Update chained_pipelines.md but chained pipelines section is not finished * Update serving_files_from_google_cloud_storage.md * Update new_relic.md * Update prometheus.md * Update datadog.md * Update image_formats_support.md * Update about_processing_pipeline.md * Update healthcheck.md * Update memory_usage_tweaks.md * Remove GIF/ICO/BMP/HEIF/AVIF support sections from docs/image_formats_support.md * Minor fixes of the docs * Update serving_files_from_azure_blob_storage.md * Fix issue with x and y offset for 're' watermark property * Fix params description in docs/watermark.md * Fix Alexander Madyankin GH name * Special thanks to Travis * Fix README Co-authored-by: DarthSim <darthsim@gmail.com>
27 lines
860 B
Markdown
27 lines
860 B
Markdown
# Serving local files
|
|
|
|
imgproxy can be configured to process files from your local filesystem. To use this feature, do the following:
|
|
|
|
1. Set `IMGPROXY_LOCAL_FILESYSTEM_ROOT` environment variable to your local images directory path.
|
|
2. Use `local:///path/to/image.jpg` as the source image URL.
|
|
|
|
### Example
|
|
|
|
Assume you want to process an image that is stored locally at `/path/to/project/images/logos/evil_martians.png`. Run imgproxy with `IMGPROXY_LOCAL_FILESYSTEM_ROOT` set to your images directory:
|
|
|
|
```bash
|
|
IMGPROXY_LOCAL_FILESYSTEM_ROOT=/path/to/project/images imgproxy
|
|
```
|
|
|
|
Then, use the path inside this directory as the source URL:
|
|
|
|
```
|
|
local:///logos/evil_martians.png
|
|
```
|
|
|
|
The URL for resizing this image to fit 300x200 will look like this:
|
|
|
|
```
|
|
http://imgproxy.example.com/insecure/rs:fit:300:200:no:0/plain/local:///logos/evil_martians.png@jpg
|
|
```
|