KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

docker-thumbor

★ 293 Open GitHub ↗

Docker image for thumbor. Detectors, optimizers, lazy detection and separate docker for remotecv.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Minimal Usage
================
```
$ docker run -p 8000:8000 apsl/thumbor
$ wget http://localhost:8000/unsafe/300x300/i.imgur.com/bvjzPct.jpg
```

Docker thumbor and remotecv
========================

[![Docker Pulls](https://img.shields.io/docker/pulls/apsl/thumbor.svg)](https://hub.docker.com/r/apsl/thumbor/)
[![Docker Stars](https://img.shields.io/docker/stars/apsl/thumbor.svg)](https://hub.docker.com/r/apsl/thumbor/)
[![Build Status](https://travis-ci.org/APSL/docker-thumbor.svg?branch=master)](https://travis-ci.org/APSL/docker-thumbor)

Docker image for thumbor, and separated one for remotecv, necessary for the lazy detection.  
All parameters of the thumbor config can be set with env vars.  
The thumbor's docker expose port 8000 with the service.  
Consider to use the docker-thumbor-nginx image to use nginx like a first cache.  
The nginx cache check if the file exists in a shared volume (file_storage) after to send the request to thumbor (automated failover).  
We propose two thumbor images aspl/thumbor and apsl/thumbor-multiprocess.  
The first one (monoprocess) to use under a docker organization tool and the second one use circus to increase the number of thumbor processes. Use multiprocess if you need to deploy in one host and scale up.  
The remotecv could be scaled increasing the number of docker images using the same redis queue.

Description
===========

Docker thumbor image

* All configuration via environment variables
* Opencv detectors
* Optimizer JPEG included
* Nginx cache to optimize the server of result images in a separated docker image
* Separated remotecv docker image, with AWS S3 loader support.
* Use the official python images and best practices
* A lot of docker-compose examples with tipical uses cases
* envtpl to setup config files on start time, based on environ vars. https://github.com/andreasjansson/envtpl

Ports
=====

* 8000: thumbor

Docker-compose examples
=======================

Check the docker-compose examples:

* [Simple detection](https://github.com/APSL/docker-thumbor/blob/master/configuration_examples/docker-compose/detector.yml)
* [Lazy detection using redis](https://github.com/APSL/docker-thumbor/blob/master/configuration_examples/docker-compose/lazy-detector.yml)
* [AWS S3 storage](https://github.com/APSL/docker-thumbor/blob/master/configuration_examples/docker-compose/aws-s3-storage.yml)
* [Proposed use in production, reading from a AWS S3 and local cache of storage/result_storage](https://github.com/APSL/docker-thumbor/blob/master/configuration_examples/docker-compose/production.yml)

Env vars and default value:
=========
    THUMBOR_LOG_FORMAT='%(asctime)s %(name)s:%(levelname)s %(message)s'
    THUMBOR_LOG_DATE_FORMAT='%Y-%m-%d %H:%M:%S'
    MAX_WIDTH=0
    MAX_HEIGHT=0
    MIN_WIDTH=1
    MIN_HEIGHT=1
    ALLOWED_SOURCES=[]
    QUALITY=80
    WEBP_QUALITY=None
    PNG_COMPRESSION_LEVEL=6
    AUTO_WEBP=False
    MAX_AGE=86400
    MAX_AGE_TEMP_IMAGE=0
    RESPECT_ORIENTATION=False
    IGNORE_SMART_ERRORS=False
    PRESERVE_EXIF_INFO=False
    ALLOW_ANIMATED_GIFS=True
    USE_GIFSICLE_ENGINE=False
    USE_BLACKLIST=False
    LOADER='thumbor.loaders.http_loader'
    STORAGE='thumbor.storages.file_storage'
    AWS_ACCESS_KEY_ID='' -> Note: New in version 5.2.1c
    AWS_SECRET_ACCESS_KEY='' -> Note: New in version 5.2.1c
    RESULT_STORAGE='thumbor.result_storages.file_storage'
    ENGINE='thumbor.engines.pil'
    SECURITY_KEY='MY_SECURE_KEY'
    ALLOW_UNSAFE_URL=True
    ALLOW_OLD_URLS=True
    FILE_LOADER_ROOT_PATH='/data/loader'
    HTTP_LOADER_CONNECT_TIMEOUT=5
    HTTP_LOADER_REQUEST_TIMEOUT=20
    HTTP_LOADER_FOLLOW_REDIRECTS=True
    HTTP_LOADER_MAX_REDIRECTS=5
    HTTP_LOADER_FORWARD_USER_AGENT=False
    HTTP_LOADER_DEFAULT_USER_AGENT='Thumbor/5.2.1'
    HTTP_LOADER_PROXY_HOST=None
    HTTP_LOADER_PROXY_PORT=None
    HTTP_LOADER_PROXY_USERNAME=None
    HTTP_LOADER_PROXY_PASSWORD=None
    HTTP_LOADER_CA_CERTS=None
    HTTP_LOADER_VALIDATE_CERTS=True
    HTTP_LOADER_CLIENT_KEY=None
    HTTP_LOADER_CLIENT_CERT=None
    HTTP_LOADER_CURL_ASYNC_HTTP_CLIENT=False
    STORAGE_EXPIRATION_SECONDS=2592000
    STORES_CRYPTO_KEY_FOR_EACH_IMAGE=False
    FILE_STORAGE_ROOT_PATH='/data/storage'
    UPLOAD_MAX_SIZE=0
    UPLOAD_ENABLED=False
    UPLOAD_PHOTO_STORAGE='thumbor.storages.file_storage'
    UPLOAD_DELETE_ALLOWED=False
    UPLOAD_PUT_ALLOWED=False
    UPLOAD_DEFAULT_FILENAME='image'
    MONGO_STORAGE_SERVER_HOST='mongo'
    MONGO_STORAGE_SERVER_PORT='27017'
    MONGO_STORAGE_SERVER_DB='thumbor'
    MONGO_STORAGE_SERVER_COLLECTION='images'
    REDIS_STORAGE_SERVER_HOST='redis'
    REDIS_STORAGE_SERVER_PORT='6379'
    REDIS_STORAGE_SERVER_DB=0
    REDIS_STORAGE_SERVER_PASSWORD=None
	REDIS_RESULT_STORAGE_SERVER_HOST='redis'
	REDIS_RESULT_STORAGE_SERVER_PORT=6379
	REDIS_RESULT_STORAGE_SERVER_DB=0
	REDIS_RESULT_STORAGE_SERVER_PASSWORD=None
    MEMCACHE_STORAGE_SERVERS=['localhost:11211',]
    MIXED_STORAGE_FILE_STORAGE='thumbor.storages.no_storage'
    MIXED_STORAGE_CRYPTO_STORAGE='thumbor.storages.no_storage'
    MIXED_STORAGE_DETECTOR_STORAGE='thumbor.storages.no_storage'
    META_CALLBACK_NAME=None
    DETECTORS=[]
    FACE_DETECTOR_CASCADE_FILE='haarcascade_frontalface_alt.xml'
    OPTIMIZERS=[]
    JPEGTRAN_PATH='/usr/bin/jpegtran'
    PROGRESSIVE_JPEG=True
    FILTERS=['thumbor.filters.brightness', 'thumbor.filters.contrast', 'thumbor.filters.rgb', 'thumbor.filters.round_corner', 'thumbor.filters.quality', 'thumbor.filters.noise', 'thumbor.filters.watermark', 'thumbor.filters.equalize', 'thumbor.filters.fill', 'thumbor.filters.sharpen', 'thumbor.filters.strip_icc', 'thumbor.filters.frame', 'thumbor.filters.grayscale', 'thumbor.filters.rotate', 'thumbor.filters.format', 'thumbor.filters.max_bytes', 'thumbor.filters.convolution', 'thumbor.filters.blur', 'thumbor.filters.extract_focal', 'thumbor.filters.no_upscale']
    RESULT_STORAGE_EXPIRATION_SECONDS=0
    RESULT_STORAGE_FILE_STORAGE_ROOT_PATH='/data/result_storage'
    RESULT_STORAGE_STORES_UNSAFE=False
    REDIS_QUEUE_SERVER_HOST='redis'
    REDIS_QUEUE_SERVER_PORT='6379'
    REDIS_QUEUE_SERVER_DB='0'
    REDIS_QUEUE_SERVER_PASSWORD=None
    SQS_QUEUE_KEY_ID=None
    SQS_QUEUE_KEY_SECRET=None
    SQS_QUEUE_REGION='us-east-1'
    USE_CUSTOM_ERROR_HANDLING=False
    ERROR_HANDLER_MODULE='thumbor.error_handlers.sentry'
    ERROR_FILE_LOGGER=None
    ERROR_FILE_NAME_USE_CONTEXT='False'
    SENTRY_DSN_URL=''
    TC_AWS_REGION='eu-west-1'
    TC_AWS_ENDPOINT=None
    TC_AWS_STORAGE_BUCKET=''
    TC_AWS_STORAGE_ROOT_PATH=''
    TC_AWS_LOADER_BUCKET=''
    TC_AWS_LOADER_ROOT_PATH=''
    TC_AWS_RESULT_STORAGE_BUCKET=''
    TC_AWS_RESULT_STORAGE_ROOT_PATH=''
    TC_AWS_STORAGE_SSE=False
    TC_AWS_STORAGE_RRS=False
    TC_AWS_ENABLE_HTTP_LOADER=False
    TC_AWS_ALLOWED_BUCKETS=False
    TC_AWS_STORE_METADATA=False

docker-thumbor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README