Serverless image manager

image upload / download with resizing. Used API gateway's binary support & serverless

View on Github

Lambda Image Manager

Lambda Image Manager is AWS Lambda function that store, get, manipulate images in AWS S3.

If you are using Cloudinary or Imgix like service just for resizing or basic image manipulation, maybe you don't need them anymore.

Before Start

If you aren't used to Serverless or AWS Lambda, I highly recommend that read Serverless docs first.

Remember! AWS provides free tier amount, but this whole service is not FREE.

Todo List

  • Add DynamoDB logic.


  • Make empty AWS S3 bucket for image file store. ~~- Make and set AWS DynamoDB for cache.~~(Not supported yet)


git clone
cd lambda-image-manager
npm install

And set production environment. (If you want to stage or other)

# /env/prod.yml
S3_BUCKET_NAME: lambdaImage
S3_DEST_PREFIX: images/original

The S3 folder structure should be like below.

# lambdaImage Bucket


Then if you ready to deploy Serverless project, just run

npm run deploy:prod


Set API Gateway (this image is actually from my own service by using this repository)

You should set lambda-image-manager's API Gateway's binary support option.

At API Gateway setting page, set binary option allow header to "image/*". Then, Deploy API Gateway once again in console dashboard.

Running the tests


How It Works


  • A browser try to presentation tag with src property heading our API gateway that trigger lambda function.
  • Lambda get request with image id, image file name, image manipulation options.
  • Trying to find pre-manipulated result from AWS DynamoDB as cache. If the target image is already manipulated with same option, then read that image's address from DynamoDB and return redirect response to that address.
  • If there is no cache, manipulate target image with given options.
  • Change the image to Buffer with BASE64 encode.
  • After that, store the result to S3 and record result address to DynamoDB with manipulation options.
  • return manipulated target image to user.

Built With




  • Tylor Shin - Project Manager - TylorShin
  • breath103 - Tech lead & Initial idea maker - breath103