1
0
mirror of https://github.com/imgproxy/imgproxy.git synced 2025-01-08 10:45:04 +02:00
imgproxy/docs/installation.md
Andrey Novikov f697cedf43
Add link to imgproxy package published in AUR for Arch Linux users
Fun fact: actually AUR doesn't contain packages and software is being build every time from the sources on end user's machine. So it is long and loud process. But it is as simple as package manager – you just check imgproxy and it will be installed for you along with libvips.
2019-06-19 23:23:56 +03:00

2.0 KiB

Installation

There are four 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:

Deploy

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

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

Packages

Arch Linux and derivatives

imgproxy package is available from AUR.

From the source

Ubuntu

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: https://github.com/libvips/ 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:

$ CGO_LDFLAGS_ALLOW="-s|-w" go get -f -u github.com/imgproxy/imgproxy

macOS + Homebrew

$ brew install vips go
$ PKG_CONFIG_PATH="$(brew --prefix libffi)/lib/pkgconfig" \
  CGO_LDFLAGS_ALLOW="-s|-w" \
  CGO_CFLAGS_ALLOW="-Xpreprocessor" \
  go get -f -u github.com/imgproxy/imgproxy