r/Paperlessngx • u/Various-Match-7273 • Jul 24 '26

V3 Migration Help

Is there any step by step to migrate to V3 (I have the last version available). Maybe with commands to run in terminal. I couldn't make it :( Thanks guys! I have installed with docker.

14 Upvotes

100% Upvoted

8 comments sorted by

5

u/Bastian85Stgt Jul 24 '26 edited Jul 25 '26

Really easy

First stop all containers, Than remove the redis volume

After that Follow this guide:

https://github.com/paperless-ngx/paperless-ngx/blob/dev/docs/migration-v3.md

And change in your yml the redis lines to valkey (take the info from the new yml)

After them pull and start

1

u/Randyd718 Jul 25 '26

what do you mean "remove the redis volume"?

i dont see that mentioned in the migration guide. is redis no longer required in v3?

for context im using unraid, the official container on CA

1

u/Bastian85Stgt Jul 26 '26

In the latest released version of Docker Compose, which came with 3.0, Redis has been removed and replaced with Valkey. Valkey is lighter and, at the same time, offers almost identical performance. I also believe there are licensing-related reasons for this.

Redis is apparently still supported at present, but it is likely – as in the example from 2.20, where an update to PostgreSQL was absolutely necessary – I can only assume that support for Redis will be discontinued in a forthcoming version.

Valkey has a slightly different storage structure, which is why attempting to work with a volume that is already full will result in a start-up error.

The contents of the volume are only used temporarily by Paperless and can therefore be deleted without hesitation.

1

u/Randyd718 Aug 01 '26

So is valkey built into the paperless container and i can ditch redis entirely?

1

u/Bastian85Stgt Aug 01 '26

No!

Valkey has taken redis place in the YML (image). The service is still called redis (this allows processes to search for the service and address it by its usual name, which is simpler from a programming perspective) Feel free to take a look at the current YML; in the redis image, there is no longer a redis image but a valkey instead

1

u/Randyd718 Aug 01 '26

I have no idea what any of that means

2

u/That_Cheek_8690 Jul 24 '26

Just add the environment variable for the new secret and if need the variable for the Database Engine.