# Serving files from OpenStack Object Storage ("Swift")

imgproxy can process images from OpenStack Object Storage, also known as Swift. To use this feature, do the following:

1. Set the `IMGPROXY_USE_SWIFT` environment variable to `true`
2. Configure Swift authentication with the following environment variables
   * `IMGPROXY_SWIFT_USERNAME`: the username for Swift API access. Default: blank
   * `IMGPROXY_SWIFT_API_KEY`: the API key for Swift API access. Default: blank
   * `IMGPROXY_SWIFT_AUTH_URL`: the Swift Auth URL. Default: blank
   * `IMGPROXY_SWIFT_AUTH_VERSION`: the Swift auth version, set to 1, 2 or 3 or leave at 0 for autodetect.
   * `IMGPROXY_SWIFT_TENANT`: the tenant name (optional, v2 auth only). Default: blank
   * `IMGPROXY_SWIFT_DOMAIN`: the Swift domain name (optional, v3 auth only): Default: blank

3. Use `swift://%{container}/%{object_path}` as the source image URL, e.g. an original object storage URL in the format of `/v1/{account}/{container}/{object_path}`, such as `http://127.0.0.1:8080/v1/AUTH_test/images/flowers/rose.jpg`, should be converted to `swift://images/flowers/rose.jpg`.

---

## Navigation

- [Getting started](/3.25.x/getting_started)
- [imgproxy Pro](https://imgproxy.net#pro)
- [Installation](/3.25.x/installation)
- [Configuration](/3.25.x/category/configuration)
  - [Configuration options](/3.25.x/configuration/options)
  - [Loading environment variables](/3.25.x/configuration/loading_environment_variables)
- [Usage](/3.25.x/category/usage)
  - [Processing an image](/3.25.x/usage/processing)
  - [Getting an image info](/3.25.x/usage/getting_info)
  - [Signing a URL](/3.25.x/usage/signing_url)
  - [Encrypting a source URL](/3.25.x/usage/encrypting_source_url)
  - [Presets](/3.25.x/usage/presets)
- [Features](/3.25.x/category/features)
  - [Watermark](/3.25.x/features/watermark)
  - [Object detection](/3.25.x/features/object_detection)
  - [Autoquality](/3.25.x/features/autoquality)
  - [Best format](/3.25.x/features/best_format)
  - [Chained pipelines](/3.25.x/features/chained_pipelines)
- [Image sources](/3.25.x/category/image-sources)
  - [Serving local files](/3.25.x/image_sources/local_files)
  - [Serving files from Amazon S3](/3.25.x/image_sources/amazon_s3)
  - [Serving files from Google Cloud Storage](/3.25.x/image_sources/google_cloud_storage)
  - [Serving files from Azure Blob Storage](/3.25.x/image_sources/azure_blob_storage)
  - [Serving files from OpenStack Object Storage ("Swift")](/3.25.x/image_sources/openstack_swift)
- [Monitoring](/3.25.x/category/monitoring)
  - [New Relic](/3.25.x/monitoring/new_relic)
  - [Prometheus](/3.25.x/monitoring/prometheus)
  - [Datadog](/3.25.x/monitoring/datadog)
  - [OpenTelemetry](/3.25.x/monitoring/open_telemetry)
  - [Amazon CloudWatch](/3.25.x/monitoring/cloud_watch)
- [Image formats support](/3.25.x/image_formats_support)
- [About the processing pipeline](/3.25.x/about_processing_pipeline)
- [Health check](/3.25.x/healthcheck)
- [Memory usage tweaks](/3.25.x/memory_usage_tweaks)

## Other versions

- [4.0.x (current)](/image_sources/openstack_swift)
- [latest (unstable)](/latest/image_sources/openstack_swift)
- [3.31.x](/3.31.x/image_sources/openstack_swift)
- [3.30.x](/3.30.x/image_sources/openstack_swift)
- [3.29.x](/3.29.x/image_sources/openstack_swift)
- [3.28.x](/3.28.x/image_sources/openstack_swift)
- [3.27.x](/3.27.x/image_sources/openstack_swift)
- [3.26.x](/3.26.x/image_sources/openstack_swift)
- [3.24.x](/3.24.x/image_sources/openstack_swift)
- [3.23.x](/3.23.x/image_sources/openstack_swift)
- [3.22.x](/3.22.x/image_sources/openstack_swift)
- [3.21.x](/3.21.x/image_sources/openstack_swift)
- [3.20.x](/3.20.x/image_sources/openstack_swift)
- [3.19.x](/3.19.x/image_sources/openstack_swift)