[GH-ISSUE #21435] issue: PWA Install Failures on Android: Manifest Truncation & Icon Issues #58146

Closed
opened 2026-05-05 22:24:47 -05:00 by GiteaMirror · 6 comments
Owner

Originally created by @ncrosty58 on GitHub (Feb 15, 2026).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/21435

Check Existing Issues

  • I have searched for any existing and/or related issues.
  • I have searched for any existing and/or related discussions.
  • I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!).
  • I am using the latest version of Open WebUI.

Installation Method

Docker

Open WebUI Version

Latest

Ollama Version (if applicable)

No response

Operating System

Debian

Browser (if applicable)

No response

Confirmation

  • I have read and followed all instructions in README.md.
  • I am using the latest version of both Open WebUI and Ollama.
  • I have included the browser console logs.
  • I have included the Docker container logs.
  • I have provided every relevant configuration, setting, and environment variable used in my setup.
  • I have clearly listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc).
  • I have documented step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation. My steps:
  • Start with the initial platform/version/OS and dependencies used,
  • Specify exact install/launch/configure commands,
  • List URLs visited, user input (incl. example values/emails/passwords if needed),
  • Describe all options and toggles enabled or changed,
  • Include any files or environmental changes,
  • Identify the expected and actual result at each stage,
  • Ensure any reasonably skilled user can follow and hit the same issue.

Expected Behavior

Android users cannot install the PWA because the manifest.json is both broken and non-compliant.

Actual Behavior

​1. Manifest Truncation
When served through a proxy (Caddy/Nginx), the JSON is cut off mid-stream.
​Proof: curl -L ends abruptly at "par instead of }}.
​Result: Invalid JSON; Android rejects the PWA.

​2. Non-Standard Icons
Chrome on Android requires specific icon sizes to trigger the "Install" prompt.
​Current: 500x500
​Required: 192x192 and 512x512.
​Proposed Fix:
​Fix backend Content-Length headers to prevent truncation.
​Update manifest.json icons array to include standard 192x192 and 512x512 sizes.

Steps to Reproduce

Android pwa not working

Logs & Screenshots

NA

Additional Information

No response

Originally created by @ncrosty58 on GitHub (Feb 15, 2026). Original GitHub issue: https://github.com/open-webui/open-webui/issues/21435 ### Check Existing Issues - [x] I have searched for any existing and/or related issues. - [x] I have searched for any existing and/or related discussions. - [x] I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!). - [x] I am using the latest version of Open WebUI. ### Installation Method Docker ### Open WebUI Version Latest ### Ollama Version (if applicable) _No response_ ### Operating System Debian ### Browser (if applicable) _No response_ ### Confirmation - [x] I have read and followed all instructions in `README.md`. - [x] I am using the latest version of **both** Open WebUI and Ollama. - [x] I have included the browser console logs. - [x] I have included the Docker container logs. - [x] I have **provided every relevant configuration, setting, and environment variable used in my setup.** - [x] I have clearly **listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup** (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc). - [x] I have documented **step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation**. My steps: - Start with the initial platform/version/OS and dependencies used, - Specify exact install/launch/configure commands, - List URLs visited, user input (incl. example values/emails/passwords if needed), - Describe all options and toggles enabled or changed, - Include any files or environmental changes, - Identify the expected and actual result at each stage, - Ensure any reasonably skilled user can follow and hit the same issue. ### Expected Behavior Android users cannot install the PWA because the manifest.json is both broken and non-compliant. ### Actual Behavior ​1. Manifest Truncation When served through a proxy (Caddy/Nginx), the JSON is cut off mid-stream. ​Proof: curl -L ends abruptly at "par instead of }}. ​Result: Invalid JSON; Android rejects the PWA. ​2. Non-Standard Icons Chrome on Android requires specific icon sizes to trigger the "Install" prompt. ​Current: 500x500 ​Required: 192x192 and 512x512. ​Proposed Fix: ​Fix backend Content-Length headers to prevent truncation. ​Update manifest.json icons array to include standard 192x192 and 512x512 sizes. ### Steps to Reproduce Android pwa not working ### Logs & Screenshots NA ### Additional Information _No response_
GiteaMirror added the bug label 2026-05-05 22:24:47 -05:00
Author
Owner

@Classic298 commented on GitHub (Feb 15, 2026):

Cannot reproduce, reads to me like misconfiguration of NGINX

https://docs.openwebui.com/reference/https/nginx

Be careful to read the recommended stuff and what to not configure

<!-- gh-comment-id:3904723277 --> @Classic298 commented on GitHub (Feb 15, 2026): Cannot reproduce, reads to me like misconfiguration of NGINX https://docs.openwebui.com/reference/https/nginx Be careful to read the recommended stuff and what to not configure
Author
Owner

@ncrosty58 commented on GitHub (Feb 15, 2026):

Thank you for responding. I'm using caddy, all is working well except for this pwa app

<!-- gh-comment-id:3904763716 --> @ncrosty58 commented on GitHub (Feb 15, 2026): Thank you for responding. I'm using caddy, all is working well except for this pwa app
Author
Owner

@Classic298 commented on GitHub (Feb 15, 2026):

I can install it just fine on Android, Edge and Chrome tested

<!-- gh-comment-id:3904810136 --> @Classic298 commented on GitHub (Feb 15, 2026): I can install it just fine on Android, Edge and Chrome tested
Author
Owner

@ncrosty58 commented on GitHub (Feb 15, 2026):

Here is my assessment FWIW: In version v0.8.1, the PWA installation fails on mobile because the root manifest.json is being served as an empty object {} and the sw.js service worker is completely missing from the /app/build directory in the official Docker image.

<!-- gh-comment-id:3905330733 --> @ncrosty58 commented on GitHub (Feb 15, 2026): Here is my assessment FWIW: In version v0.8.1, the PWA installation fails on mobile because the root manifest.json is being served as an empty object {} and the sw.js service worker is completely missing from the /app/build directory in the official Docker image.
Author
Owner

@Classic298 commented on GitHub (Feb 15, 2026):

sorry still cant reproduce even on 0.8.1 - tried with brave and chrome on android now on a different device and it still just works

<!-- gh-comment-id:3905437335 --> @Classic298 commented on GitHub (Feb 15, 2026): sorry still cant reproduce even on 0.8.1 - tried with brave and chrome on android now on a different device and it still just works
Author
Owner

@ncrosty58 commented on GitHub (Feb 16, 2026):

Figured it out. It is because I have been using olauncher.

When I switched back to pixel launcher pwa app worked right away

<!-- gh-comment-id:3906191523 --> @ncrosty58 commented on GitHub (Feb 16, 2026): Figured it out. It is because I have been using olauncher. When I switched back to pixel launcher pwa app worked right away
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#58146