Thumbor S3 Docker

A docker image for Thumbor with AWS S3 / Minio integration for cropping, resizing, applying filters and optimizing images on the fly.

A little of introduction

Thumbor S3 Docker is available in two variants of docker images, lightweight (slim) - slim-alpine and full-featured - alpine.

All current docker images are packed with these features:

• AWS S3 / Minio integration support
• jpegtran (already enabled) lossless jpeg optimizer which can make jpegs smaller by optimizing DCT coefficients.
• gifsicle allows to generate proper animated gifs, as well as static gifs with the smallest possible size.
• thumbor-aws Official extension for asynchronous non-blocking AWS S3 support.
• Support for Prometheus metrics collector.
• Healthcheck inside the docker container is already configured, it controls that Thumbor service works properly.

The full-featured (alpine) version contains these extra functionality:

• gifv optimizer which is able to convert gifs to mp4 or webm videos, often resulting in dramatically smaller sized files.
• Ability to process SVG files.
• Image Metadata allows to work with image's metadata.

Before choosing the full-featured image version, make sure that you really need these extra functionality, since the resulting docker container is two times bigger than slim-alpine

Currently maintained docker images:

thumbor-s3:alpine
thumbor-s3:slim-alpine
thumbor-s3:7-alpine
thumbor-s3:7-slim-alpine
thumbor-s3:7.4-alpine
thumbor-s3:7.4-slim-alpine

Docker Hub | Github packages

Configuring Thumbor S3

All the configuration can be done via environment variables. For a list of all the variables, please check this config file.
Use variable names from the file as the environment variables to configure your docker container. Apart from variables in the config file mentioned above, there are some extra environment variables:

• PORT - The port to run this Thumbor instance at. Default: 8888
• LOG_LEVEL - The log level to be used. Possible values are: debug, info, warning, error, critical. Default: warning
• NUM_PROCESSES - Number of Thumbor processes to run. Possible values are: 0 - auto detect, 1 - no forks created, or set your number. Default: 0

Also, don't forget to take a look at the official documentation on how to use Thumbor imaging.

Securing thumbor

On production systems please consider the following options:

• ALLOW_UNSAFE_URL (default False): Disallow "unsafe" (non HMAC-signed) URLs Docs
• SECURITY_KEY (default 31337): a shared secret for HMAC-signing URLs

Please check out HMAC signing in the docs for more information.

Volume mapping

/data:/data

Healthcheck

On production, you should enable a healthcheck to make sure, that your service is up and running. Luckily thumbor comes with a simple healthcheck API built-in.

By default, it's https//host:port/healthcheck/. You can change it with the HEALTHCHECK_ROUTE environment variable.

How to use this image

Please take a look at this example, it explains everything you need to know to begin working with Thumbor.

Issues

Bug reports and feature requests can be submitted on the Github Issue Tracker.

Credits

Thumbor contributors

License

The MIT License (MIT). Please see License File for more information.

---

If you love this project, please consider giving me a ⭐