Paperless-ngx broke with latest update

[nedhedrick]

I have had Paperless-ngx running on UmbrelOS 1.5 for some time. I attempted to install the latest update for Paperless-ngx (2.20.5). The update failed to complete, after which the app was no longer usable. I attempted to uninstall and re-install Paperless-ngx and it would not install. Then I spun up a new image of UmbrelOS 1.5 and tried to install Paperless-ngx on a “fresh” UmbrelOS, and that also failed. There were no error messages at any point. It appears the latest release of Paperless-ngx is not installable on UmbrelOS.

Any help would be appreciated!

If this forum is not appropriate for this problem, please let me know if there is a better place to submit this error.

[RodB]

If Paperless-ngx is not giving any logs … then, they must be going to the System logs.

In Umbrel, goto Settings, Troubleshoot, umbrelOS

The errors that Paperless-ngx is giving, should be in that log.

[nedhedrick]

Thanks for your quick response! Here is the log from the install attempt for Paperless-ngx:

Jan 28 21:13:06 umbrel umbreld[1202]: [apps ] Installing app paperless
Jan 28 21:13:06 umbrel umbreld[1202]: [apps ] Setting up data directory for paperless
Jan 28 21:13:06 umbrel umbreld[48207]: time=“2026-01-28T21:13:06Z” level=warning msg=“/opt/umbreld/source/modules/apps/legacy-compat/docker-compose.yml: the attribute version is obsolete, it will be ignored, please remove it to avoid potential confusion”
Jan 28 21:13:06 umbrel umbreld[48207]: Container tor_proxy Running
Jan 28 21:13:06 umbrel umbreld[48207]: Container auth Running
Jan 28 21:13:06 umbrel dockerd[829]: time=“2026-01-28T21:13:06.906143642Z” level=warning msg="reference for unknown type: " digest=“sha256:59521628c3b4aa4e37c976924f74c30e507acd89eea2dbc74f13f0354159f536” remote=“ghcr.io/paperless-ngx/paperless-ngx@sha256:59521628c3b4aa4e37c976924f74c30e507acd89eea2dbc74f13f0354159f536”
Jan 28 21:13:07 umbrel dockerd[829]: time=“2026-01-28T21:13:07.231661929Z” level=info msg=“Attempting next endpoint for pull after error: manifest unknown”
Jan 28 21:13:07 umbrel umbreld[1202]: [apps ] [error] Failed to install app paperless
Jan 28 21:13:07 umbrel umbreld[1202]: Error: (HTTP code 404) unexpected - manifest unknown
Jan 28 21:13:07 umbrel umbreld[1202]: at /opt/umbreld/node_modules/docker-modem/lib/modem.js:382:17
Jan 28 21:13:07 umbrel umbreld[1202]: at handler (/opt/umbreld/node_modules/docker-modem/lib/modem.js:425:11)
Jan 28 21:13:07 umbrel umbreld[1202]: at IncomingMessage. (/opt/umbreld/node_modules/docker-modem/lib/modem.js:414:9)
Jan 28 21:13:07 umbrel umbreld[1202]: at IncomingMessage.emit (node:events:536:35)
Jan 28 21:13:07 umbrel umbreld[1202]: at IncomingMessage.emit (node:domain:489:12)
Jan 28 21:13:07 umbrel umbreld[1202]: at endReadableNT (node:internal/streams/readable:1698:12)
Jan 28 21:13:07 umbrel umbreld[1202]: at process.processTicksAndRejections (node:internal/process/task_queues:90:21) {
Jan 28 21:13:07 umbrel umbreld[1202]: reason: undefined,
Jan 28 21:13:07 umbrel umbreld[1202]: statusCode: 404,
Jan 28 21:13:07 umbrel umbreld[1202]: json: null
Jan 28 21:13:07 umbrel umbreld[1202]: }

I have installed a couple of other apps successfully so this seems to only be an issue with Paperless-ngx.

I’m no Docker expert so most of this is not familiar to me. Any help you can offer will be appreciated!

[RodB]

@nedhedrick

“ghcr.io/paperless-ngx/paperless-ngx

Looks to me it is having problems finding the Docker Image!

Where are you trying to install this from or what instructions are you trying to follow?

paperlessngx/paperless-ngx - Docker Image

[nedhedrick]

I am attempting to install directly from the “app store” in umbrel, using the blue “Install” button at the top right of the Paperless-ngx page. Info section on that page shows it coming from the Paperless-ngx Community, submitted by highghlow. Nothing fancy or unusual beyond what is provided in the umbrel app-store…

I have installed Homebox and Technitium DNS using exactly the same method and they worked fine…

[RodB]

umbrel@umbrel M45Core:~/umbrel/app-data/paperless$ # This forces Docker to re-verify the digests
sudo -E docker compose pull
[+] Pulling 6/6
tika Pulled 0.3s
broker Pulled 0.3s
✘ webserver Error manifest unknown 0.7s
gotenberg Pulled 0.3s
db Pulled 0.3s
! app_proxy Interrupted 0.7s
Error response from daemon: manifest unknown

So, the manifest error is on the Webserver Docker Image. The image was probably updated and now the docker-compose.yml file is out of date.

Hopefully, you can do Unix CLI Commands … ssh into your umbrelOS …

cd ~/umbrel/app-data/paperless

Run this command to remove the hash data check to pull the current docker images:

$ sed -i ‘s/@sha256:[a-z0-9]*//g’ docker-compose.yml

Don’t run this command … let the Umbrel do it but I just wanted to show that it did get the docker images:

umbrel@umbrel M45Core:~/umbrel/app-data/paperless$ sudo -E docker compose pull
[+] Pulling 43/43
db Pulled 14.5s
gotenberg Pulled 0.8s
app_proxy Pulled 0.8s
broker Pulled 11.5s
tika Pulled 0.8s
webserver Pulled 22.5s

tika Pulled 0.7s
umbrel@umbrel M45Core:~/umbrel/app-data/paperless$ sudo -E docker compose up -d
[+] Running 7/7
Network paperless_default Created 0.0s
Container paperless_db_1 Started 0.4s
Container paperless_gotenberg_1 Started 0.3s
Container paperless_app_proxy_1 Started 0.5s
Container paperless_broker_1 Started 0.3s
Container paperless_tika_1 Started 0.4s
Container paperless_webserver_1 Started

umbrel@umbrel M45Core:~/umbrel/app-data/paperless$ sudo -E docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
paperless_broker_1 Docker Hub Container Image Library | App Containerization “docker-entrypoint.s…” broker 40 seconds ago Up 40 seconds 6379/tcp
paperless_db_1 Docker Hub Container Image Library | App Containerization “docker-entrypoint.s…” db 40 seconds ago Up 40 seconds 5432/tcp
paperless_gotenberg_1 docker.io/gotenberg/gotenberg:7.10 “/usr/bin/tini – go…” gotenberg 40 seconds ago Up 40 seconds 3000/tcp
paperless_tika_1 apache/tika:3.2.3.0 “/bin/sh -c 'exec ja…” tika 40 seconds ago Up 40 seconds 9998/tcp
paperless_webserver_1 Package paperless-ngx · GitHub “/init” webserver 40 seconds ago Up 39 seconds (healthy) 8000/tcp
umbrel@umbrel M45Core:~/umbrel/app-data/paperless$ ss -tulpn
Netid State Recv-Q Send-Q Local Address:Port Peer Address:Port Process
udp UNCONN 0 0 0.0.0.0:5353 0.0.0.0:*
udp UNCONN 0 0 0.0.0.0:56453 0.0.0.0:*
udp UNCONN 0 0 172.17.255.255:137 0.0.0.0:*
udp UNCONN 0 0 172.17.0.1:137 0.0.0.0:*
udp UNCONN 0 0 10.21.255.255:137 0.0.0.0:*
udp UNCONN 0 0 10.21.0.1:137 0.0.0.0:*
udp UNCONN 0 0 192.168.6.255:137 0.0.0.0:*
udp UNCONN 0 0 192.168.6.24:137 0.0.0.0:*
udp UNCONN 0 0 0.0.0.0:137 0.0.0.0:*
udp UNCONN 0 0 172.17.255.255:138 0.0.0.0:*
udp UNCONN 0 0 172.17.0.1:138 0.0.0.0:*
udp UNCONN 0 0 10.21.255.255:138 0.0.0.0:*
udp UNCONN 0 0 10.21.0.1:138 0.0.0.0:*
udp UNCONN 0 0 192.168.6.255:138 0.0.0.0:*
udp UNCONN 0 0 192.168.6.24:138 0.0.0.0:*
udp UNCONN 0 0 0.0.0.0:138 0.0.0.0:*
udp UNCONN 0 0 [::]:5353 [::]:*
udp UNCONN 0 0 [::]:44374 [::]:*
tcp LISTEN 0 128 0.0.0.0:22 0.0.0.0:*
tcp LISTEN 0 4096 0.0.0.0:2000 0.0.0.0:*
tcp LISTEN 0 128 [::]:22 [::]:*
tcp LISTEN 0 511 :80 :
tcp LISTEN 0 4096 [::]:2000 [::]:
umbrel@umbrel M45Core:~/umbrel/app-data/paperless$ sudo docker ps --format “table {{.Names}}\t{{.Ports}}”
NAMES PORTS
paperless_webserver_1 8000/tcp
paperless_broker_1 6379/tcp
paperless_gotenberg_1 3000/tcp
paperless_db_1 5432/tcp
paperless_tika_1 9998/tcp
auth 0.0.0.0:2000->2000/tcp, [::]:2000->2000/tcp
tor_proxy
umbrel@umbrel M45Core:~/umbrel/app-data/paperless$

So, I can manually get it to come up but I have no idea what do with this application.

Looks like the paperless UI with Port 2349 but the app did not come up.

Try looking on their Github Support Page: paperless-ngx/paperless-ngx · Discussions · GitHub

[nedhedrick]

Thank you so much for your research into this failure! As I said, I am no Docker expert – that’s the reason I use a tool like umbrel…

I have an umbrel image I use for testing so I will try both the manual install and the umbrel install later today to verify.