Skip to content

πŸ› οΈ v0.26.1 – Patch Release

Latest

Choose a tag to compare

@icereed icereed released this 08 Jul 12:48

πŸ› οΈ 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/PGID collisions 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 numeric su-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.
  • 🟒 HOME is now set after the privilege drop, so configs land in /home/paperless-gpt even when the UID resolves to a pre-existing user (e.g. nobody/65534).
  • 🟒 OpenAI-compatible endpoints without the Azure flag: OPENAI_BASE_URL now works for any OpenAI-compatible service (LM Studio, LiteLLM, vLLM, OpenRouter, …) β€” no OPENAI_API_TYPE workaround 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

  1. Update your paperless-gpt Docker image/tag to v0.26.1.
  2. 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