Skip to content

S3 Reverse Proxy with GET, PUT and DELETE methods and authentication (OpenID Connect and Basic Auth)


Notifications You must be signed in to change notification settings


Repository files navigation

Mentioned in Awesome Go Go Doc Github Actions Go Report Card

Coverage Status Docker Pulls GitHub license GitHub release (latest by date)


  • Multi S3 bucket proxy
  • Index document (display index document instead of listing when found)
  • Custom templates
  • Custom S3 endpoints supported
  • Basic Authentication support
  • Multiple Basic Authentication support
  • OpenID Connect Authentication support
  • Multiple OpenID Connect Provider support
  • Redirect to original host and path with OpenID Connect authentication
  • Bucket mount point configuration with hostname and multiple path support
  • Authentication by path and http method on each bucket
  • Prometheus metrics
  • Allow to publish files on S3 bucket
  • Allow to delete files on S3 bucket

And many others.


There is an online documentation generated for this project.

You can find it here:

Advanced interfaces

Looking for more advanced interfaces. Take a look on this project: s3-proxy-interfaces.

Want to contribute ?

Inspired by


  • My wife BH to support me doing this


  • Oxyno-zeta (Havrileck Alexandre)


Apache 2.0 (See in LICENSE)