{"id":13486887,"url":"https://github.com/beeyev/thumbor-s3-docker","last_synced_at":"2025-12-28T20:42:46.435Z","repository":{"id":43510811,"uuid":"486731330","full_name":"beeyev/thumbor-s3-docker","owner":"beeyev","description":"A docker image for thumbor with AWS S3 / Minio integration for cropping, resizing, applying filters and optimizing images on the fly.","archived":false,"fork":false,"pushed_at":"2024-10-01T10:11:25.000Z","size":357,"stargazers_count":50,"open_issues_count":1,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-30T22:39:41.042Z","etag":null,"topics":["docker-image","thumbor","thumbor-docker"],"latest_commit_sha":null,"homepage":"","language":"Smarty","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beeyev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-28T19:57:19.000Z","updated_at":"2024-10-26T04:23:51.000Z","dependencies_parsed_at":"2024-03-30T23:28:51.641Z","dependency_job_id":"5bfeaae7-eb01-404f-aade-d72e2c9c0998","html_url":"https://github.com/beeyev/thumbor-s3-docker","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeyev%2Fthumbor-s3-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeyev%2Fthumbor-s3-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeyev%2Fthumbor-s3-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeyev%2Fthumbor-s3-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beeyev","download_url":"https://codeload.github.com/beeyev/thumbor-s3-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245927251,"owners_count":20695196,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-image","thumbor","thumbor-docker"],"created_at":"2024-07-31T18:00:52.539Z","updated_at":"2025-12-28T20:42:46.393Z","avatar_url":"https://github.com/beeyev.png","language":"Smarty","funding_links":[],"categories":["Hosting Thumbor"],"sub_categories":[],"readme":"# [Thumbor S3 Docker](https://github.com/beeyev/thumbor-s3-docker)  \n\u003e A Docker image for Thumbor with AWS S3 and Minio integration, designed for on-the-fly image cropping, resizing, applying filters, and image optimization.\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/beeyev/thumbor-s3-docker\"\u003e\u003cimg src=\"https://github.com/beeyev/thumbor-s3-docker/raw/master/docs/img/thumbor-s3-docker.jpg\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n## A little of introduction\nThumbor S3 Docker is available in two variants of docker images, a lightweight (slim) - `slim-alpine` and a full-featured  - `debian`.\n\n### All current docker images are packed with these features:\n - AWS S3 / Minio integration support\n - [`jpegtran`](https://thumbor.readthedocs.io/en/stable/jpegtran.html?highlight=Jpegtran#jpegtran) (already enabled) lossless jpeg optimizer which can make jpegs smaller by optimizing DCT coefficients.\n - [`gifsicle`](https://thumbor.readthedocs.io/en/stable/configuration.html?highlight=gifsicle#use-gifsicle-engine) allows to generate proper animated gifs, as well as static gifs with the smallest possible size.\n - [`thumbor-aws`](https://github.com/thumbor/thumbor-aws) Official extension for asynchronous non-blocking AWS S3 support.  \n - [`sentry-client`](https://thumbor.readthedocs.io/en/latest/custom_error_handling.html) Sentry error handling client.  \n - Support for Prometheus metrics collector.\n - Healthcheck inside the docker container is already configured, it controls that Thumbor service works properly.\n\n### The full-featured (`debian`) version provides all possible functionality such as:  \n - [`gifv`](https://thumbor.readthedocs.io/en/stable/gifv.html) optimizer which is able to convert gifs to mp4 or webm videos, often resulting in dramatically smaller sized files.\n - [Facial Detection](https://thumbor.readthedocs.io/en/latest/detection_algorithms.html) support.\n - Ability to process SVG, AVIF and HEIF files.\n - [Lazy Detection](https://thumbor.readthedocs.io/en/latest/lazy_detection.html) functionality.\n - [`Image Metadata`](https://thumbor.readthedocs.io/en/stable/metadata.html) allows to work with image's metadata.  \n- High Efficiency Image Format `avif`, `heif` support.  \n\n\u003e Before choosing the full-featured image version, make sure that you really need this extra functionality, as the resulting Docker container is three times larger than `slim-alpine`.\n\n### Currently maintained docker images:  \n`beeyev/thumbor-s3:debian`  \n`beeyev/thumbor-s3:slim-alpine`  \n`beeyev/thumbor-s3:7-debian`  \n`beeyev/thumbor-s3:7-slim-alpine`  \n`beeyev/thumbor-s3:7.7-debian`  \n`beeyev/thumbor-s3:7.7-slim-alpine`\n  \n[Docker Hub](https://hub.docker.com/r/beeyev/thumbor-s3) | [Github packages](https://github.com/beeyev/thumbor-s3-docker/pkgs/container/thumbor-s3) | [Red Hat quay.io](https://quay.io/beeyev/thumbor-s3)  \n\n\n## Configuring Thumbor S3\nAll the configuration can be done via environment variables. For a list of all the variables, please check [this config file](https://github.com/beeyev/thumbor-s3-docker/raw/master/docker/config/thumbor/thumbor.conf.tpl).  \nUse variable names from the file as the environment variables to configure your docker container.\nBesides the variables mentioned in the above config file, there are some additional environment variables:  \n - `PORT` - The port to run this Thumbor instance at. Default: `8888`\n - `LOG_LEVEL` - The log level to be used. Possible values are: `debug, info, warning, error, critical`. Default: `warning`\n - `NUM_PROCESSES` - Number of Thumbor processes to run. Possible values are: `0` - auto detect, `1` - no forks created, or set your number. Default: `0`\n\nAlso, don't forget to take a look at [the official documentation](https://thumbor.readthedocs.io/en/latest) on how to use Thumbor imaging.\n\n### Securing thumbor\nOn production systems please consider the following options:\n\n- `ALLOW_UNSAFE_URL` (default `False`): Disallow \"unsafe\" (non HMAC-signed) URLs [Docs](https://thumbor.readthedocs.io/en/latest/configuration.html#allow-unsafe-url)\n- `SECURITY_KEY` (default `31337`): a shared secret for HMAC-signing URLs\n\nPlease check out [HMAC signing](https://thumbor.readthedocs.io/en/latest/security.html) in the docs for more information.\n\n### Volume mapping\n`/data:/data`\n\n### Healthcheck\nOn 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](https://thumbor.readthedocs.io/en/latest/configuration.html#healthcheck).\n\nBy default, it's `https//host:port/healthcheck/`.\n\n## How to use this image\nPlease take a look at [**this example**](https://github.com/beeyev/thumbor-s3-docker/tree/master/examples/read-from-S3-cache-to-S3), it explains everything you need to know to begin working with Thumbor.\n\n## Issues\nBug reports and feature requests can be submitted on the [Github Issue Tracker](https://github.com/beeyev/thumbor-s3-docker/issues).\n\n## Credits\n[Thumbor contributors](https://github.com/thumbor/thumbor/graphs/contributors)  \n\n## License\nThe MIT License (MIT). Please see [License File](https://github.com/beeyev/thumbor-s3-docker/raw/master/LICENSE.md) for more information.\n\n---\nIf you love this project, please consider giving me a ⭐\n\n![](https://visitor-badge.laobi.icu/badge?page_id=beeyev.thumbor-s3-docker) [![Docker Pulls](https://img.shields.io/docker/pulls/beeyev/thumbor-s3)](https://hub.docker.com/r/beeyev/thumbor-s3)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeeyev%2Fthumbor-s3-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeeyev%2Fthumbor-s3-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeeyev%2Fthumbor-s3-docker/lists"}