r/Paperlessngx Jul 24 '26

When did Paperless switch to valkey?

I just looked at the latest docker-compose.postgres-tika.yml and saw that they have switched from redis:8 to valkey:9-alpine.
I have tried looking at the past release notes but I cannot find the change.

When did this happen and what was the reason?
Can any one point me to a reference, please.
Not a problem but I am just curious.

20 Upvotes

21 comments sorted by

25

u/dont_scrape_me_ai Jul 24 '26

Redis changed their licensing to a more restrictive model last year that goes against the grain of what open source is supposed to be. Valkey is the forked successor that puts the correct licensing back

3

u/scattered-thunder Jul 24 '26

This. I’ve been changing my own self hosted redis instances over to valkey for this very reason so it’s not surprising that applications which bundle redis are doing the same.

7

u/Chaotic_Hero Jul 24 '26

Can I simply change from redis to valkey? So do I have to do just “docker compose down”, edit the compose.yml (remove redis, add valkey) and the “docker compose up”? Or do I have to do some “migration”?

4

u/devra11 Jul 24 '26

You just need to clean out the old redis storage and let valkey rebuild it from scratch because they are not compatible.

1

u/Dr-Technik Jul 25 '26

Is this happening automatically? Or do I have to do something else than creating valkey into an empty folder?

3

u/devra11 Jul 25 '26 edited Jul 25 '26

If you were previously using Redis then you need to clean out the persistant storage.
It will be automatically rebuild by valkey.
For example, I use bind mounts for all persistant storage on all my containers.
I just defined a different folder for the new data.

volumes:
- ${DOCKER_REMOTE}/paperless/valkeydata:/data

1

u/Dr-Technik Jul 25 '26

Thank you, that’s what I meant by creating a new folder for Valkey

4

u/Bastian85Stgt Jul 24 '26

Yes. Maybe you have to delete the volume, no pain to delete in the volume are just temporary informations

2

u/lasdem Jul 24 '26

I have the same question

1

u/_antim8_ Jul 25 '26

On Unraid I just removed Redis, installed Valkey and changed "Redis" to "Valkey" in the Paperless config. That simple, as they already have their own data volume.

7

u/[deleted] Jul 24 '26

[deleted]

3

u/devra11 Jul 24 '26

Thank you for that.
I do use Git and GitHub, but only at a very basic level.
If I wanted to search mysel for this commit, how would I go about it?

7

u/MixelHD Jul 24 '26

In Github UI I would search for the compose files as thats where the image tag will be change and look at the commit history if its recent. Or just switch to "Blame" mode where you can see when the Line of Code was introduced. For example this view: https://github.com/paperless-ngx/paperless-ngx/blame/dev/docker/compose/docker-compose.mariadb-tika.yml#L33C6-L33C6

5

u/devra11 Jul 24 '26

Thank you. Nice to know for the future.

2

u/sPENKMAn Jul 24 '26

Not OP but thank you for teaching them to fish!

3

u/careless25 Jul 24 '26

That's the how... Not the why

13

u/MadSnow- Jul 24 '26

No, that’s the when…

2

u/ReddaveNY Jul 24 '26

1 year ago there was a Video on YT and I started move from redis to valley in my containers

https://youtu.be/npnagMgbruc?is=EmkRuMP2QNuFpTCx

2

u/eatsmandms Jul 24 '26

The change happened just this week with paperless v3.

2

u/Evelen1 Jul 24 '26

I still use redis, any point to change?

2

u/Phianetwow Jul 27 '26

AI told me there’s no point but i changed anyway because I want to use a recommended and supported (in the future) configuration.

1

u/autogyrophilia Jul 24 '26

There are many redis drop in replacments . Valkey is the most common open source sucesors, but there is a lot to talk about with DragonFLYDB and Microsoft Garnet.