Docker image compression

Self-hosted image compression for Docker

ImgCompress is a private Docker image compressor and converter for people who do not want to upload files to an online compressor. Run it on a server, NAS, homelab or workstation, then compress and convert batches from your browser.

Install with DockerView formats
localhost:3001
ImgCompress web UI for private batch image compression and conversion
UI variant
Docker setup

Deploy a private image compressor where your files already live

The page is for users searching for a Docker image compression tool, not a hosted upload service. Start with a single command, or use Docker Compose for a persistent NAS, homelab or internal team server.

Full Docker installation guide

Quick Docker run

Best for trying ImgCompress locally or running it on a workstation.

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

Docker Compose

Best for a server, NAS, homelab or team instance that should restart automatically.

services:
  imgcompress:
    image: karimz1/imgcompress:latest
    container_name: imgcompress
    restart: always
    ports:
      - "3001:5000"
Why self-host it

Image compression for private files and repeatable jobs

Most image compression tools are public web services. ImgCompress is different: it runs where your files already live and gives you a browser UI plus CLI for repeatable jobs. That makes it useful when images are private, large, numerous or part of an internal publishing workflow.

Step 1

Deploy the container

Start ImgCompress with docker run, Docker Compose or Coolify and open the local web interface.

Step 2

Process private files

Drop in single files or batches, then choose compression, conversion, resizing or local background removal.

Step 3

Reuse the workflow

Save one file, download the whole batch as a ZIP, or use the CLI when a repeatable job fits better.

Private batch compression

Process folders of images with quality controls and ZIP downloads without sending source files to a third-party service.

Converter inside the same container

Convert HEIC, HEIF, WebP, AVIF, PNG, JPG, PSD, TIFF, GIF, PDF and many other formats from the same Docker app.

Docker-first deployment

Run image compression on your own server, NAS, homelab, workstation, Coolify instance or private network.

No public upload step

Photos, screenshots and design files stay on your infrastructure because processing happens locally in the container.

Compared with upload tools

ImgCompress vs online image compressors

Online compressors are convenient for public files. A self-hosted image compressor is a better fit when privacy, repeatable batches and Docker deployment matter.

File privacy
Files are uploaded to someone else before compression.
Files stay on your Docker host, NAS, server or workstation.
Batch workflow
Often limited by upload size, queue limits or account tiers.
Process private batches and download results as a ZIP.
Deployment
Depends on an external website and its availability.
Runs as your own Docker container with web UI and CLI access.
Format coverage
Usually focused on common JPG, PNG or WebP files.
Supports 70+ formats including HEIC, AVIF, WebP, PSD, TIFF and PDF.
Self-hosted use cases

Use one private tool for websites, archives and teams

Compress images to reduce file size, convert them to modern formats, or keep an internal image conversion workflow available for everyone on your network.

Compress website assets before deployment
Convert iPhone HEIC or HEIF photos to WebP or JPG
Shrink product images before marketplace uploads
Run a private image converter on a NAS or homelab server
Give a team one internal compression tool for sensitive files
Keep repeatable image processing available on an offline network
Answers

Common questions about ImgCompress

Quick answers for people comparing self-hosted image compression tools, Docker image converters, and private alternatives to online compressors.

Is ImgCompress an image compression tool for Docker?

Yes. ImgCompress runs as a Docker container and provides a web UI and CLI for image compression, conversion, resizing and batch processing.

How is ImgCompress different from online image compressors?

ImgCompress runs on your own Docker host, so you do not need to upload private photos, screenshots, product images or design files to a public web service.

Can ImgCompress work as a self-hosted image converter?

Yes. ImgCompress converts 70+ image formats, including HEIC, HEIF, PSD, AVIF, WebP, PNG, JPG, TIFF, GIF and PDF, while running on your own infrastructure.

Does ImgCompress upload images to the cloud?

No. ImgCompress processes files inside your own Docker container, so photos, screenshots and design files stay on your machine, NAS or private server.

Can I run ImgCompress on a NAS, homelab or internal server?

Yes. ImgCompress is designed for Docker, so it fits Linux servers, NAS devices that support containers, homelab machines, Coolify deployments and private team servers.

Who is this self-hosted image compression page for?

It is built for self-hosters, homelab users, developers, designers and teams that need private batch image compression instead of a public online compressor.

Start compressing

Run ImgCompress locally in about a minute

Pull the Docker image, open the web UI, then compress and convert images from your browser.

View installation guide