Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time


There are four ways you can install imgproxy:


imgproxy can (and should) be used as a standalone application inside a Docker container. Just pull the official image from Docker Hub:

docker pull darthsim/imgproxy:latest
docker run -p 8080:8080 -it darthsim/imgproxy

You can also build your own image. imgproxy is ready to be dockerized, plug and play:

docker build -f docker/Dockerfile -t imgproxy .
docker run -p 8080:8080 -it imgproxy


imgproxy can be easily deployed to your Kubernetes cluster using Helm and our official Helm chart:

helm repo add imgproxy

# With Helm 3
helm upgrade -i imgproxy imgproxy/imgproxy

# With Helm 2
helm upgrade -i --name imgproxy imgproxy/imgproxy

Read the chart's README for more info.


imgproxy can be deployed to Heroku with a click of a button:


However, you can do it manually with a few steps:

git clone && cd imgproxy
heroku create your-application
heroku stack:set container
git push heroku master


Arch Linux and derivatives

imgproxy package is available from AUR.

macOS + Homebrew

imgproxy is available from Homebrew:

brew install imgproxy

From the source

You can get imgproxy source by cloning the GitHub repo:

git clone
cd imgproxy

...or by downloading the source tarball:

mkdir imgproxy
cd imgproxy
curl -Ls \
  | tar -xz --strip-components 1 -C .

You can also download the specific version:

mkdir imgproxy
cd imgproxy
curl -Ls \
  | tar -xz --strip-components 1 -C .


First, install libvips.

Ubuntu apt repository contains a pretty old version of libvips. You can use PPA with more recent version of libvips:

sudo add-apt-repository ppa:dhor/myway
sudo apt-get update
sudo apt-get install libvips-dev

But if you want to use all the features of imgproxy, it's recommended to build libvips from the source: libvips/wiki/Build-for-Ubuntu

Next, install the latest Go:

sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt-get update
sudo apt-get install golang-go

And finally, install imgproxy itself:

  go build -o /usr/local/bin/imgproxy

macOS + Homebrew

brew install vips go
PKG_CONFIG_PATH="$(brew --prefix libffi)/lib/pkgconfig" \
  CGO_CFLAGS_ALLOW="-Xpreprocessor" \
  go build -o /usr/local/bin/imgproxy