Web UI Guide

Use the imgcompress web interface for drag-and-drop image compression, WebP and AVIF conversion, target file-size control, and local AI background removal. All processing stays on your self-hosted server — no cloud uploads.

Get StartedUsage

Quick Start#

Make sure you've installed it first.

Step 1: Drop your images#

Drag your photos into the upload area. Adjust quality, format, and other settings before converting.

Upload and configure your imagesUpload and configure your images

Step 2: Process#

Hit convert and watch the progress. Everything runs on your own server. Nothing leaves your infrastructure.

Images being processedImages being processed

Step 3: Download#

Save images individually or grab them all as a ZIP.

Download your resultsDownload your results


Background Removal#

imgcompress includes a local AI model that removes image backgrounds entirely on your server's hardware. No cloud, no external API.

📝Format requirement

To preserve transparency, choose AVIF or PNG as your output format. JPEG does not support transparency.

How to use it#

  1. Select AVIF or PNG as the output format.
  2. Toggle the Remove Background switch on.
  3. Convert as normal.

Toggle background removalToggle background removal

Example#

Here is what the AI background removal looks like on a landscape photo:

OriginalBackground removed
Original landscape with sunsetOriginal landscape with sunsetLandscape with background removedLandscape with background removed

Target a Specific File Size#

Need your image under 1 MB for a website upload? imgcompress can hit a target size.

  1. Choose a format. JPG or AVIF gives the best compression-to-quality ratio.

    Select formatSelect format

  2. Add your images to the queue.

    Add filesAdd files

  3. Open "Set by File Size", enter your limit (e.g. 1 MB), and convert.

    Set max file sizeSet max file size


Storage Management#

imgcompress stores processed files on the server for easy re-download. You can manage them from the Storage panel.

Storage management panelStorage management panel

💡Disable storage management

If you don't want users to see processed files, add DISABLE_STORAGE_MANAGEMENT=true to the environment: section of your docker-compose.yml. → See the docker-compose setup


Privacy#

imgcompress is self-hosted. Your files never leave your own server and nothing is sent to any external service. Only you (and anyone you give access to your server) can see your uploaded files. See Privacy & Safety for details.