Frequently asked questions

• What are the steps to get imgproxy?

  Open source version Install from GitHub or via Docker. Check out full step-by-step guide.

  Startup or Business license

  1. Submit a purchase request or shoot us an email at imgproxy@evilmartians.com.
  2. We issue a yearly invoice via Stripe.
  3. Once the invoice is paid, we securly provide you with the keys to the private Docker repository along with instructions.

  Enterprise

  1. Submit a purchase request or shoot us an email at imgproxy@evilmartians.com.
  2. imgproxy manager conducts an interview and provides the next steps.

• How will you accept payments?

  For Startup and Business plans we issue Stripe invoices. For Enterprise plans we sign a License agreement and issue a yearly invoice.

• Who can benefit from using imgproxy?

  Everyone from newbie startups to large businesses! imgproxy is created for any website or service that has pictures, videos and PDF files. Read our article on imgproxy use cases here.

• What is the difference between Open source, Startup, Business and Enterprise imgproxy plans?

  Open source has quite a few basic features you need to get things started at no cost.

  Startup and Business licenses offer Pro features and Priority support. The difference between the two is solely the number of concurencies.

  Enterprise includes Pro features and a shared Slack channel for support and has no limit on the number of concurencies. This option is created for complex custom solutions or services that use imgproxy Pro as the backbone and can include integration/migration/customization services.

• What's a concurrency? How do I calculate it?

  License concurrency is the overall concurrency of all instances using the same license. The concurrency of a single instance can be configured with the IMGPROXY_CONCURRENCY config. If you run 5 instances with a concurrency of 2, your concurrency is 10.

• What is OSS imgproxy licensed under?

  OSS version is currently licensed under MIT. Read more about it here: https://github.com/imgproxy/imgproxy/blob/master/LICENSE

• Do you offer support?

  Definitely! For Startup and Business we offer priority support — feature requests in these plans have priority over others and are taken into consideration first. Enterprise plan has real-time support in the shared Slack channel. And, of course, if you use any version of imgproxy, including the free one, or none at all, you can post your question here: https://github.com/imgproxy/imgproxy/issues

• Can I try imgproxy Pro for free?

  Yes, shoot us an email at imgproxy@evilmartians.com to get a 2-week trial. We'll deploy a test instance in the Heroku environment for you to try.

• Do you have discounts for non-profits?

  Yes, we try to support businesses and organizations that do good in the world. For a chance at reduced rates, or even a free Pro version reach out to us at imgrpoxy@evilmartians.com with your statement on how you intend to use imgrpoxy.

• Do you have discounts for educational organisations?

  Yes, we do! Please reach out to us at imgproxy@evilmartians.com to learn whether you qualify.

• Will the free version ever expire?

  Free forever, imgproxy OSS is forever free. We, Evil Martians, value the Open Source community and will continue supporting fellow developers in this way.

• Is there an imgproxy commmunity?

  There is a vivid imgproxy community on Gitter: https://gitter.im/imgproxy/imgproxy. Join us there!

• Can third parties use my license?

  No, license transfer is not allowed under the imgproxy Pro plans. If you have doubts about what plan fits your case best please reach out to imgproxy@evilmartians.com

• Do I need plugins or image library configuration to use imgproxy?

  Nope. Install imgproxy via GitHub or via Docker. Read simple step-by-step guide: https://evilmartians.com/chronicles/introducing-imgproxy

• What security measures do you take?

  We take security seriously. Read more on the measures we take: https://docs.imgproxy.net/?id=security

• What happens if I miscalculate the concurency? Can I upgrade or downgrade my account?

  We provide yearly Pro subscription. You can upgrade from Startup to Business by reaching out to us at imgproxy@evilmartians.com, however, we do not offer downgrades and refunds.

• Can I refund my purchase?

  Sorry but we do not offer any refunds.

• What is the ideal server setup for imgproxy?

  The first and main rule - imgproxy responses should be cached as it doesn't have an internal cache. A couple of 1CPU 512MB servers + CDN + metrics is a good starting point. E.g., CDNs like AWS CloudFront work perfectly with imgproxy.

  As for the server itself, imgproxy scales better horizontally than vertically. A swarm of single-core instances is better than one big instance. The default IMGPROXY_CONCURRENCY value is perfect in most cases, we do not recommend changing it until acquiring several metrics. Memory consumption highly depends on the images and the way imgproxy is used. The rough prediction: 512MB should be enough unless there is an especially high number of big images processed.

  See full guide in our documentation

• What video formats are supported?

  We support numerous codecs and containers including the most popular MP4/H.264.

• What are the requirements for object detection and NSFW detection?

  If you provide a model for object detection or use the Docker image with the model provided, imgproxy can detect objects on the image and use them for smart crop, blurring the detections, or drawing the detections. If you want, you can train your model to detect NSFW (not safe for work) content.

• How does object detection work with false positive results?

  You can configure the confidence threshold for detections. Also, you can fine-tune your model if you think the detection results aren't satisfactory for you.

• Can I blur elements or just the whole image?

  There're two processing options: one for blurring the whole image, and one for blurring the object detection results.

• Do you have any limitation for requests per second/image size?

  imgproxy doesn't have limitations for RPS yet it has configurable concurrency (max images processed simultaneously). Also, imgproxy has configurable limitations for the source image resolution.

• What images formats object detection support? What happends with animated formats?

  Object detection works for every image format supported by imgproxy including animated ones. In case of animated images, imgproxy detects objects on every frame separately. The only exception is SVG-to-SVG as, in this case, imgproxy doesn't process the image.

• Is hosting included?

  Since imgproxy is adaptable for any enironment, you choose your hosting and make all the hosting arrangements on your own.

• Is a hosted version / SaaS model is not something you offer?

  The core idea of imgproxy is to enjoy all the benefits of the standalone/installed to your cluster proxying server. We believe that choosing the environment that best fits your needs and gives you control over the image optimization processes is much safer. That's why we don't offer a hosted version and SaaS solutions.

• What are the terms and conditions for the Early Access program?

  The Early Access program provides full access to imgproxy Pro 3.0, packed with new advanced and machine learning-based features, for free until November 30, 2021. Adopters can choose between Startup and Business plans to try Pro. At the end of the trial, all participants get a $100 discount for the first year for any Pro plan they choose (including Enterprise). In return, users are asked to report all bugs and issues found in Pro 3.0, and to send their feature requests to a dedicated Slack channel (we’ll send an invitation when joining the program) to help us to advance and improve the product. To become an Early Access adopter, sign up on Product Hunt and complete this form by October 31, 2021.