[GH-ISSUE #407] Docker: add REDIS_HOST and REDIS_PORT variables #321

New issue

Closed

opened 2026-02-25 21:31:41 +03:00 by kerem · 3 comments

kerem commented

2026-02-25 21:31:41 +03:00

Owner

Originally created by @matejdro on GitHub (Jul 27, 2021).
Original GitHub issue: https://github.com/ciur/papermerge/issues/407

Originally assigned to: @ciur on GitHub.

I want to use papermerge images, but I do not want to use papermerge's docker compose (I want to use one postgres and one redis instance for all my services instead of every service setting up their own).

This worked with the postgres (papermerge thankfully provides environment variables for setting that), but It appears that currently redis is hardcoded to always connect to the redis hostname. From what I can see, this breaks the worker (it does not startup without redis).

Please add a way to setup worker without redis (I'm using this personally, so there is no need for big caching on my side) or to change redis hostname, so I can use existing redis server.

Originally created by @matejdro on GitHub (Jul 27, 2021). Original GitHub issue: https://github.com/ciur/papermerge/issues/407 Originally assigned to: @ciur on GitHub. I want to use papermerge images, but I do not want to use papermerge's docker compose (I want to use one postgres and one redis instance for all my services instead of every service setting up their own). This worked with the postgres (papermerge thankfully provides environment variables for setting that), but It appears that currently redis is hardcoded to always connect to the `redis` hostname. From what I can see, this breaks the worker (it does not startup without redis). Please add a way to setup worker without redis (I'm using this personally, so there is no need for big caching on my side) or to change redis hostname, so I can use existing redis server.

kerem

2026-02-25 21:31:41 +03:00

closed this issue
added the
enhancement

feature request
labels

kerem commented

2026-02-25 21:31:41 +03:00

Author

Owner

@matejdro commented on GitHub (Jul 29, 2021):

In the meantime I'm using docker image from linuxserver: https://github.com/linuxserver/docker-papermerge. This image is standalone and provides all of above options.

@matejdro commented on GitHub (Jul 29, 2021): In the meantime I'm using docker image from linuxserver: https://github.com/linuxserver/docker-papermerge. This image is standalone and provides all of above options.

kerem commented

2026-02-25 21:31:41 +03:00

Author

Owner

@stavros-k commented on GitHub (Dec 19, 2021):

those vars will also help in deploying it on kubernetes!

@stavros-k commented on GitHub (Dec 19, 2021): those vars will also help in deploying it on kubernetes!

kerem commented

2026-02-25 21:31:41 +03:00

Author

Owner

@ciur commented on GitHub (Jul 31, 2022):

Available since 2.1.0a35.

Here is docker compose file example (redis configuration is passed via PAPERMERGE__REDIS__HOST, PAPERMERGE__REDIS__PORT, notice double underscores).

And here is relevant documentation

Actually as of 2.1.0 configuration is "environment variables" first.

@ciur commented on GitHub (Jul 31, 2022): Available since [2.1.0a35](https://github.com/papermerge/papermerge-core/pkgs/container/papermerge/30997992?tag=2.1.0a35). Here is [docker compose file example](https://github.com/papermerge/papermerge-core/blob/master/docker/docker-compose.yml) (redis configuration is passed via ``PAPERMERGE__REDIS__HOST``, ``PAPERMERGE__REDIS__PORT``, notice double underscores). And here is relevant [documentation](https://docs.papermerge.io/Settings/redis.html) Actually as of 2.1.0 configuration is "environment variables" first.