imgproxy/docs/installation.md

Installation

There are three ways you can install imgproxy:

Docker

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 -t imgproxy .
$ docker run -p 8080:8080 -it imgproxy

Heroku

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

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

$ git clone https://github.com/DarthSim/imgproxy.git && cd imgproxy
$ heroku create your-application
$ heroku stack:set container
$ git push heroku master

From the source

1. First, install libvips.

   # macOS
   $ brew tap homebrew/science
   $ brew install vips
   
   # Ubuntu
   # Ubuntu apt repository contains a pretty old version of libvips.
   # It's recommended to use PPA with an up to date version.
   $ sudo add-apt-repository ppa:dhor/myway
   $ sudo apt-get install libvips-dev
     
   # FreeBSD
   pkg install -y pkgconf vips
   

Note: Most libvips packages come with WebP support. If you want libvips to support WebP on macOS, you need to install it this way:

  $ brew tap homebrew/science
  $ brew install vips --with-webp

1. Next, install imgproxy itself:

   $ go get -f -u github.com/DarthSim/imgproxy