Original Media Storage

Details about storage systems supported by Gumlet

What is original media storage?

Gumlet does not store your original media. You must store original media in storage of your choice and give us read access to those storage systems.

Storing media on your storage system ensures you always retain full control over media. You can prevent vendor lock-ins and have full rights to your original media.

Storage Providers

We support following storage providers. You can setup your source with any of them.

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.

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

You can also specify referrer 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 referrer restriction.

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

Wasabi Storage

Gumlet supports storing images in Wasabi storage. You can configure the storage in same way and we need same permissions as Amazon S3 for wasabi storage.

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.

Cloudinary

If you have stored images in Cloudinary storage, you can setup Gumlet to fetch original images from Cloudinary and process them through our system.