FAQ: Common Questions
Slow AI upscaling, big images and memory, notifications not arriving, expired results, shared use, and safe updates.
HelpUsage
Slow AI upscaling, big images and memory, notifications not arriving, expired results, shared use, and safe updates.
Short answers for things people run into. Setup steps stay on the linked pages.
| Question | Answer |
|---|---|
| How do I convert images? | Using imgcompress: drop files, pick format, Start Converting, download. |
| Can I close the tab? | Yes. The job keeps running in the container. Reopen in the same browser. Background jobs |
| How long are results kept? | 48 hours after the last activity. Download what you need, or use Manage Stored Files. |
| Why can't I open my result on my phone? | The job key lives in the browser that started it. Use Notify me when done with PUBLIC_BASE_URL for a private link, or start the job on that device. |
| What does Cancel do? | Stops the job in the container (canceled). No download, no notification. (Needs imgcompress with the cancel API.) |
| Question | Answer |
|---|---|
| Why is it slow? | It runs on the CPU inside your container. Minutes are normal; big images on 1–2 cores take longer. One upscale runs at a time; others wait. |
| Which image type should I pick? | Photo (keep details) is the web default. Try Balanced or Old or noisy photo if the result looks too sharp or too smooth. Same speed. |
| Memory pressure on a small NAS? | Lower WEB_WORKERS (e.g. 2) so web workers use less RAM. Upscaling has its own CPU threads and is separate. Config |
| Question | Answer |
|---|---|
| I don't see the switch | NOTIFY_URL is not set (or the container wasn't restarted). Setup |
| Nothing arrives | Container can reach the service in NOTIFY_URL; credentials match. For ntfy: same topic in the app and URL. Check docker logs imgcompress (URL is never logged). |
| No download link in the message | Set PUBLIC_BASE_URL to the address you open in the browser (e.g. https://imgcompress.lan). |
| Question | Answer |
|---|---|
| "This file is no longer here" / expired | Past the 48-hour window or cleared in Storage. Convert again. |
| Can others see my files? | Not via job URLs — each job has a secret key. The Storage panel lists converted files for everyone who can open the UI; hide it with DISABLE_STORAGE_MANAGEMENT=true. |
| Do my images leave the container? | No. Notifications send only a short text (and an optional link), never images or file names. Privacy |
| Question | Answer |
|---|---|
| How do I update safely? | docker compose pull && docker compose up -d. From 0.9 → 1.0: Upgrade to 1.0 (no breaking changes). |
| Full compose examples? | docker-compose.yml (minimal) · advanced · proxied · homelab-traefik-ntfy · compose README |