🛠️ v0.26.1 – Patch Release
Summary
This patch release fixes a regression introduced in v0.26.0 which prevented the container from starting when PUID/PGID collide with users or groups that already exist in the image — most notably on Unraid, which requires PUID=99/PGID=100 (Alpine ships the group users with GID 100, so the container died with addgroup: gid '100' in use in a restart loop).
What's fixed
- 🟢
PUID/PGIDcollisions no longer crash the container: the entrypoint now looks up the requested numeric IDs and reuses pre-existing user/group entries instead of failing. Privileges are dropped with numericsu-exec uid:gid, so exactly the requested IDs apply regardless of which entry they resolve to. - 🟢 Unraid works out of the box with
PUID=99/PGID=100. - 🟢
HOMEis now set after the privilege drop, so configs land in/home/paperless-gpteven when the UID resolves to a pre-existing user (e.g.nobody/65534). - 🟢 OpenAI-compatible endpoints without the Azure flag:
OPENAI_BASE_URLnow works for any OpenAI-compatible service (LM Studio, LiteLLM, vLLM, OpenRouter, …) — noOPENAI_API_TYPEworkaround needed.
Also included: internal CI improvements (secret-free PR pipeline with mock E2E, environment-approval gate for real-LLM E2E runs — #992, #993, #994).
How to upgrade
- Update your paperless-gpt Docker image/tag to
v0.26.1. - No migration steps or config changes are needed.
Thanks
Thank you @DennaGherlyn for the quick report and the Unraid details!
- #995: "addgroup: gid '100' in use after update to 0.26.0"
What's Changed
- fix(entrypoint): support PUID/PGID that collide with existing users/groups in 227b061
- feat: OPENAI_BASE_URL for any OpenAI-compatible endpoint + secret-free mock E2E by @icereed in #993
- ci: secret-free PR pipeline + environment-approval gate for real-LLM E2E by @icereed in #994
- fix(ci): skip registry logins on pull_request builds by @icereed in #992
Full Changelog: v0.26.0...v0.26.1