>nginx-s3-gateway

nginx-s3-gateway

Translates incoming HTTP requests into S3 API calls, retrieves objects, and serves them over standard HTTP(S)

minio

s3proxy

ceph

traefik

What is nginx-s3-gateway?

The nginx-s3-gateway image packages NGINX with a module or configuration that enables it to act as a gateway to S3 or S3-compatible object storage systems. It translates incoming HTTP requests into S3 API calls, retrieves objects, and serves them over standard HTTP(S).

This setup is useful for exposing S3 buckets as static websites, media file backends, or content delivery endpoints without requiring applications to speak the S3 API directly. It can also apply caching, authentication, and other NGINX features on top of object storage.

By combining NGINX’s high-performance proxying with S3 storage, nginx-s3-gateway provides a lightweight, flexible way to bridge object stores and web clients.

How to use this image

The nginx-s3-gateway image is generally run with environment variables or mounted configuration to point at an S3 bucket.

Examples:

# Run nginx-s3-gateway connected to an S3 bucketdocker run -d -p 8080:8080 \\  -e S3_BUCKET=my-bucket \\  -e AWS_REGION=us-east-1 \\  -e AWS_ACCESS_KEY_ID=... \\  -e AWS_SECRET_ACCESS_KEY=... \\  nginxinc/nginx-s3-gateway:latest# Access objects through the gatewaycurl <http://localhost:8080/path/to/object.txt>

In Kubernetes, nginx-s3-gateway can be deployed as a sidecar or standalone service, often fronted by an ingress controller for public access.

Image variants

The nginx-s3-gateway image is typically published under nginxinc/nginx-s3-gateway and available in these forms:

nginx-s3-gateway:<version>

Version-pinned images (e.g., nginx-s3-gateway:0.5.0) are recommended for production to ensure consistent behavior.

nginx-s3-gateway:latest

Tracks the most recent stable release. Useful for quick testing or evaluation.

nginx-s3-gateway:dev / nightly

Built from the development branch. Intended for contributors or early adopters.

Interested in base images that start and stay clean?

Oops! Something went wrong while submitting the form.