Self-Hosting Image Optimization: A Guide to Mochify-Lite on Docker

Pulling the Image from Docker Hub

Setting up Mochify-Lite is straightforward because it is containerized. Since it is hosted on Docker Hub, you can pull the image and have the engine running in seconds.

To run the engine with optimal security and performance settings, use the following command. This configuration runs the container in the background, maps the necessary ports, and secures the environment:

docker run -d --name mochify-lite -p 5555:5555 --read-only --tmpfs /app/temp_ram_buffer:rw,size=64m,mode=1777 --security-opt=no-new-privileges mochify/mochify-lite:latest

Understanding the Configuration

If you are new to Docker, here is a quick breakdown of what these flags are doing:

• -d: Runs the container in "detached" mode (in the background).
• -p 5555:5555: Maps port 5555 of the container to port 5555 on your local machine. This is the gateway to the compression API.
• --read-only: A security best practice that makes the container's root filesystem immutable, preventing accidental or malicious changes.
• --tmpfs: Since the filesystem is read-only, this creates a small, fast 64MB buffer in RAM for the engine to process images temporarily.
• --security-opt=no-new-privileges: Prevents the container processes from gaining additional privileges, adding an extra layer of security.

Once the command finishes, your local image compression engine is live and ready to receive requests at http://localhost:5555. Further example configuration can be found on GitHub.

Using the API for Image Compression

Once your container is running, you have a high-performance compression engine sitting at the ready. Unlike SaaS tools that force you through a web interface, Mochify-Lite exposes a clean REST API. This means you can integrate it into your build scripts, local workflows, or even a right-click "Quick Action" on your desktop.

The engine uses libjpeg-turbo and libpng under the hood, industry-standard libraries known for their balance of high speed and surgical precision.

How to "Squish" an Image

The primary endpoint is /v1/squish. It accepts standard image formats (JPEG and PNG) up to 10MB in size. To optimize an image, you simply POST the binary data to your local endpoint:

curl -X POST "http://localhost:5555/v1/squish" -H "Content-Type: image/jpeg" --data-binary "@mochi.jpg" --output mochi_optimized.jpg

Leveling Up: Mochify vs. Mochify-Lite

While Mochify-Lite is a fantastic "drop-in" tool for standard JPEG and PNG tasks, the full Mochify engine is designed for developers who need to support the cutting edge of web performance.

If your project requires next-gen formats like AVIF or the ultra-efficient JPEG XL, you'll want to look at the full engine. Here is how they stack up: