caesium-web

caesium-web

Docker app from Soitora's Repository

Overview

A modern, privacy aware web app to compress images, all offline and within the browser.

Caesium Web Image Compressor

An image compressor that runs entirely on your browser, completely offline. Powered by libcaesium-wasm. You can try it at caesium.app.

Screenshot 2025-05-09 at 11-21-11 Caesium Image Compressor - Online

Features

  • JPG, PNG and WebP supported
  • Lossy and lossless compression
  • Keeps images metadata
  • Before/after comparison
  • Runs entirely on your browser, no images are uploaded or processed on any external server. Try loading the app and then turn off your internet connection to see the magic.

Build

Setup

Make sure to install the dependencies:

npm install

Development Server

Start the development server on http://localhost:3000:

npm run dev

Production

Build the application for production:

npm run build

Locally preview production build:

npm run preview

Run on docker

Build

You can pull the official docker images

docker pull lymphatus/caesium-app-web:latest

or build it yourself

docker build -t caesium-web-app .

Run

docker run -d -p 3000:3000 lymphatus/caesium-app-web:latest

Then you can visit localhost:3000 to start using the app.

Configuration

You can set the following ENV variables to tweak the compressor to your preferences.

  • NUXT_PUBLIC_SEND_USAGE_REPORT: (boolean | default: true) send usage stats for the compressed images to the NUXT_PUBLIC_API_ENDPOINT. Set it to false if you don't care about it.
  • NUXT_PUBLIC_API_ENDPOINT: (string | default: "") the endpoint where you can send compression stats.
  • NUXT_PUBLIC_COMPRESSOR_MAX_FILES: (number | default: 5) how many files are allowed to be added to the list in the same batch.
  • NUXT_PUBLIC_COMPRESSOR_MAX_FILE_SIZE: (number | default: 20000000) max limit for each image size, in bytes.

Install caesium-web on Unraid in a few clicks.

Find caesium-web in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for caesium-web Review the template variables and paths Click Install

Download Statistics

2,033
Total Downloads

Related apps

Details

Repository
lymphatus/caesium-app-web:latest
Last Updated2025-12-02
First Seen2025-08-05

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp
Target
3000
Default
3000
Value
3000
Max batch file countVariable

Amount of files allowed to be added to the list in the same batch.

Target
NUXT_PUBLIC_COMPRESSOR_MAX_FILES
Default
5
Value
5
Max file size for each imageVariable

Max limit for each image size, in bytes.

Target
NUXT_PUBLIC_COMPRESSOR_MAX_FILE_SIZE
Default
20000000
Value
20000000
Public API EndpointVariable

The endpoint where you can send compression stats.

Target
NUXT_PUBLIC_API_ENDPOINT
Send usage reportsVariable

Send usage stats for the compressed images to the NUXT_PUBLIC_API_ENDPOINT. Set it to false if you don't care about it.

Target
NUXT_PUBLIC_SEND_USAGE_REPORT
Default
false
Value
false