smk-branding/apps/paperless/README.md

Paperless-ngx branding — SMK

What's supported

• Custom logo: PAPERLESS_APP_LOGO env var → path to a logo image served as static.
• Paperless ships its own dark mode (matches SMK dark-first).

Assets

• Logo: ../../assets/icon.svg → serve as static file; reference in PAPERLESS_APP_LOGO.

Apply (cosmetic only)

In the paperless compose .env:

PAPERLESS_APP_LOGO=/usr/src/paperless/static/logo/icon.svg

And bind-mount assets/icon.svg into the container's static dir. Then docker compose up -d paperless-webserver (env change → recreate container; no DB/auth changes).

Note

Logo path must be inside the container. If mount friction, host via Gitea raw URL instead:

PAPERLESS_APP_LOGO=https://git.smkfam.com/larry/smk-branding/raw/branch/main/assets/icon.svg