How to Install Imgproxy on Alpine Linux

In this tutorial, you will learn how to install and configure Imgproxy on Alpine Linux. Imgproxy is an open source server that helps you to resize, crop, and rotate images on the fly. It can be easily integrated into your web applications or websites to enhance your image delivery performance.

Prerequisites

Before starting this tutorial, you need to have the following:

• A server running the latest version of Alpine Linux.
• An SSH client like PuTTY to connect to your server.
• A terminal or command-line interface to execute the commands.

Step 1: Update the Server

Before installing any packages, update the packages list and upgrade the installed packages to their latest versions.

sudo apk update
sudo apk upgrade

Step 2: Install Dependencies

Imgproxy requires some dependencies to work properly. To install them, run the following commands:

sudo apk add build-base \
openssl-dev \
libcrypto1.1 \
pkgconfig \
curl-dev \
ca-certificates

Step 3: Install Imgproxy

To install Imgproxy, follow these steps:

1. Create a new directory for the Imgproxy installation:

sudo mkdir /usr/local/src/imgproxy

2. Download the latest Imgproxy release from GitHub:

sudo curl -L -o imgproxy.tar.gz https://github.com/imgproxy/imgproxy/releases/download/v3.0.2/imgproxy-linux-amd64.tar.gz

Note: You can check for the latest release and update the above command accordingly.

3. Extract the files from the compressed files:

sudo tar -xzvf imgproxy.tar.gz -C /usr/local/src/imgproxy/

4. Create a new symlink to the extracted file:

sudo ln -s /usr/local/src/imgproxy/imgproxy-linux-amd64 /usr/local/bin/imgproxy

5. Test the Imgproxy installation by running the following command:

imgproxy -version

If the installation is successful, you should see the Imgproxy version displayed in the output.

Step 4: Configure Imgproxy

To configure Imgproxy, follow these steps:

1. Create a new configuration file:

sudo nano /etc/imgproxy.cfg

2. Copy and paste the following configuration into the file:

log_level: info

listen: 0.0.0.0:8080

ssl:
  server_key: /path/to/server.key
  server_cert: /path/to/server.crt

authorization:
  salt: your_secret_salt
  key: your_secret_key

storage:
  type: s3
  region: us-west-2
  bucket: my-images
  access_key_id: my_aws_access_key_id
  secret_access_key: my_aws_secret_access_key

processing:
  jpeg:
    quality: 90
    chroma_subsampling: "4:2:0"
  webp:
    quality: 90

stacks:
  blog:
    url: "https://www.example.com/"
    process: ["resize_to_fill", 640, 480]
    watermark: { url: "https://www.example.com/watermark.png" }

Note: You need to update the values according to your requirements.

3. Save and close the configuration file by pressing Ctrl + X, then Y, and finally Enter.

Step 5: Start the Imgproxy Service

To start the Imgproxy service, run the following command:

sudo imgproxy --config /etc/imgproxy.cfg

Note: You can add the --daemonize flag to run it as a background process.

Conclusion

Congratulations, you have successfully installed and configured Imgproxy on Alpine Linux. You can now use it to resize, crop, and rotate images on the fly in your web applications.