Setup Image Source

Provide master image location to Gumlet and setup different parameters.

Gumlet does not store images on servers. You can store your source images on storage of your choice and retain full control over them. If you stop using Gumlet, the images will no longer be available with us after CDN cache expires.

Add Source Screen

Step 1: Add Source

Source Types

Gumlet supports multiple types of image sources. Web Folders, Web Proxy, Google Cloud Storage and Amazon S3 bucket.

Web Folders

If you have source images stored in a folder in your server, you can use it as image source for Gumlet. For example, let's assume all your images are stored at example.com/source-images/ You can specify this as base URL while setting image source.

Once setup is complete, your image example.com/source-images/yourimage.jpg will be available at example.gumlet.com/yourimage.jpg. You can now manipulate the image as example.gumlet.com/yourimage.jpg?width=300

Web Proxy

A Web Proxy source allows your gumlet source to serve any image with a publicly-addressable URL. If you use this source, we recommend you URL encode all the external URLs supplied. If the external URL of image is https://domain.com/pic.jpg and you want to serve it from your web source named example, you should write URL as per below.

You can also specify referer restriction for web proxy source. You can add comma separated list of domain names and Gumlet will only allow requests from those domains. This prevents unauthorised users from using your Gumlet source on their website. By default, any referer is allowed until u add a referer restriction.

https://example.gumlet.com/https%3A%2F%2Fdomain.com%2Fpic.jpg?width=300

Amazon S3

You can use images stored in Amazon S3 bucket as image source. Gumlet needs GetObject, ListBucket and GetBucketLocation permissions to access the images. Please create access token with these permissions and add them while creating the image store.

You can optionally specify base path while creating Amazon S3 image source. If your image is stored at s3://yourbucket/some/image/path/lenna.jpg and if you specify /some/image/path as base path, your resultant URL for Gumlet will become yourdomain.gumlet.com/lenna.jpg. Without base path, the Gumlet URL will be yourdomain.gumlet.com/some/image/path/lenna.jpg

DigitalOcean Spaces

You can use images stored in DigitalOcean Spaces as image source. Please create a new access token as described in this article and create a Gumlet source with those credentials.

You can optionally specify base path while creating DigitalOcean Spaces image source. If your image is stored at do://your_space/some/image/path/lenna.jpg and if you specify /some/image/path as base path, your resultant URL for Gumlet will become yourdomain.gumlet.com/lenna.jpg. Without base path, the Gumlet URL will be yourdomain.gumlet.com/some/image/path/lenna.jpg

Google Cloud Storage

You can use images stored in Google Cloud Storage bucket as image source. Gumlet needs read bucket and list object permissions to access the images. Please create a service account with those permissions, create a JSON key and use that key while creating image source. You can find a tutorial for the same at Create and manage service account keys.

If your image is stored at gs://yourbucket/some/image/path/lenna.jpg, your resultant URL for Gumlet will become yourdomain.gumlet.com/some/image/path/lenna.jpg.

Choose Subdomain

You are required to add Gumlet subdomain through which you want to deliver your images. For example, if your website name is shoestore.com, you can choose shoestore.gumlet.com as subdomain for serving images.

Subdomain Entry Section

Step 2: Parameters

Default Parameters

While creating image source, you can also add default parameters. These are the parameters which will be applied to all images from this image source even when you don't pass them via URL parameters.

Default parameters are overridden when the same parameter is supplied via query parameter. For exmaple, if you set width as default parameter with value 300, all images served will have width of 300px by default now. If any image is requested with width=500 in URL parameters, that image will be served with 500px width.

If default parameters are applied on your image, an extra header x-gumlet-defaultparams is added in response of all images. This will help you identify which default params are applied and debug issues in image delivery.

Error Image

This image will be delivered when we can't fetch image from origin. For example, when we get 404 error from your origin server, users will see this image.

This can be useful to maintain UI quality and show a placeholder image rather than browser showing broken image.

Source Parameters