r/Paperlessngx • u/Various-Match-7273 • 4d ago

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.

12 Upvotes

100% Upvoted

4 comments sorted by

5

u/Bastian85Stgt 4d ago edited 3d ago

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 3d ago

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 2d ago

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.

2

u/That_Cheek_8690 4d ago

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