Improve documentation around Imaginary

[st3iny]

Ref nextcloud/previewgenerator#323
Ref nextcloud/server#35105

[st3iny]

/backport to stable25

[st3iny]

/backport to stable24

[szaimen]

Lets merge this after nextcloud/all-in-one#1394 is merged and released

[szaimen]

@st3iny should we maybe make somewhere clear that this requires 24.0.8 and 25.0.2 and higher to work?

[st3iny]

@st3iny should we maybe make somewhere clear that this requires 24.0.8 and 25.0.2 and higher to work?

IMO, that is not necessary. I'd assume that people update to the latest patch release. We should only inform about major version requirements (e.g. a new feature was added in a major version).

[szaimen]

@st3iny should we maybe make somewhere clear that this requires 24.0.8 and 25.0.2 and higher to work?

IMO, that is not necessary. I'd assume that people update to the latest patch release. We should only inform about major version requirements (e.g. a new feature was added in a major version).

All right then 👍

[YouveGotMeowxy]

Is it still recommended to use the image form the screenshot over the official one?

[szaimen]

Yes, the h2non imaginary image was not updated since 3 years...

[YouveGotMeowxy]

Yes, the h2non imaginary image was not updated since 3 years...

That's why I was wondering, I haven't looked to far into how many changes have been made int eh last 3 years, but according to this, it was just updated last January?

h2non/imaginary@b632dae

[szaimen]

It was updated but the docker image not if you look at docker hub.

[YouveGotMeowxy]

It was updated but the docker image not if you look at docker hub.

Oh, ok. I was just under the impression that Dhub automatically picked up changes on ghub and built the image/kept it updated there as well.

[szaimen]

was just under the impression that Dhub automatically picked up changes on ghub

Nope

[YouveGotMeowxy]

Just looked at the list of commits and it looks liek there are many:

https://github.com/h2non/imaginary/commits/master

If I were to use the dockerfile from the official and build it myself, would it be preferred? Just not sure if you guys have done anything to perhaps work specifically more efficiently or anything with NC, and I like to use the so-called latest/greatest updates for everything I use, lol

[szaimen]

Just use the aio-imaginary container. It is actually built straight from their master and has the latest dependency updates.

[YouveGotMeowxy]

ok, ty!

[Kraligor]

Might want to note that if using the aio Docker container you can't just specify a different port via -p 1234:1234 (as indicated in the Imaginary manual) but need to use 9000.. spent an hour trying to figure out what the issue was lol. Maybe add :9000 to the example too.