ImgCompress

Every image format. Zero cloud.

Convert 70+ formats, crop per file, compress in bulk, and remove backgrounds with local AI. UI in 12 languages.
Everything runs inside your container, so your files never leave your server.

Website · Docs · Installation Guide · Docker Hub · Issues

What is ImgCompress?

ImgCompress is a self-hosted image processing server that runs entirely inside a single Docker container. It handles compression, format conversion, and AI-powered background removal, all locally on your own hardware. No cloud APIs, no third-party uploads, no tracking.

Built for people, homelab enthusiasts, and anyone who values privacy and owns their data.

Features

AI Background Removal: Local & Private

Stop uploading personal or client photos to cloud-based removers. ImgCompress ships a bundled AI model that runs background removal on your own hardware. No API call, no subscription, no file ever leaves your server.

Original	Background Removed

Per-File Cropping (since v0.7.0)

Every upload gets its own crop overlay before conversion. Pick a ratio preset (Free, 1:1, 16:9, 4:3) or type exact pixel width and height. Selections are saved per file, so one batch can mix square thumbnails with 16:9 covers without re-uploading.

How to use it

1. Drop your images into the upload area as usual.
2. On any file row, click the crop icon to open the editor.
3. Pick an aspect ratio preset (1:1, 4:3, 16:9, …) or set width and height manually.
4. Zoom and crop to frame the shot exactly the way you want it.
5. Click Save to keep the crop, Discard to back out, or Remove to clear a previously saved crop.
6. Convert as normal. The crop is applied first, then your chosen format, quality, resize, and background-removal settings.

[!NOTE] Server-rendered formats: Some formats (e.g. PSD, EPS) are rendered server-side into a crop-friendly bitmap so you can still crop them in the browser.

Full walkthrough and demo video: Image Crop Editor docs.

Quick Start

Pull the image, open localhost:3001, start converting. About 60 seconds total.

docker run -d \
  --name imgcompress \
  -p 3001:5000 \
  karimz1/imgcompress:latest

For Docker Compose, environment variables, and deploying without the mascot, see the full installation guide.

Why I Built ImgCompress

I was tired of the "software loop." Every time I needed something simple, I had to install another app:

• PSD files: Needed specialized software just to convert them to an image file.
• HEIC files: Needed another converter for regular photo files.
• Image to PDF: Needed another app just to share a screenshot for work, since a PDF is often better for emails and easy for others to print.
• AI Backgrounds: I realized I needed one more app for that too.

I thought to myself: "Why can't one tool just do it all?" Plus, uploading personal photos to random online converters never felt right to me.

One Toolbox for Everything

So I built a single toolbox that can take over 70 different formats and fix them all in one place. Whether you need to convert PSD or HEIC files to an image, turn a screenshot into a PDF for a work email, or shrink a massive 4K photo, this tool does it automatically.

The community has now pulled the image tens of thousands of times, which shows the pain is real.

Why Docker?

I chose Docker because it keeps your computer clean. Instead of you having to install 70 different messy libraries on your system, I packed everything into one Ready-to-go Box that you can run anywhere called imgcompress. It just works.

Privacy by Design

Security-Hardened Architecture

ImgCompress is built with a Security-Hardened, Minimal Image architecture, bringing de facto container security standards to your homelab or production environment.

<div align="right">