From 216cf32ac25cd07e8a7613b5363e8e242b987a4d Mon Sep 17 00:00:00 2001 From: Richard Steinmetz Date: Tue, 15 Nov 2022 11:11:42 +0100 Subject: [PATCH] Improve documentation around Imaginary Ref https://github.com/nextcloud/previewgenerator/issues/323 Ref https://github.com/nextcloud/server/pull/35105 Co-authored-by: Simon L. Signed-off-by: Richard Steinmetz --- admin_manual/installation/server_tuning.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/admin_manual/installation/server_tuning.rst b/admin_manual/installation/server_tuning.rst index 72cca87c1bd..2d139c53521 100644 --- a/admin_manual/installation/server_tuning.rst +++ b/admin_manual/installation/server_tuning.rst @@ -130,6 +130,9 @@ Previews It is possible to speed up preview generation using an external microservice: `Imaginary `_. +We strongly recommend running our custom docker image that is more up to date than the official image. +You can find the image at `docker.io/nextcloud/aio-imaginary:latest` for x64-architecture. For arm64-architecture, there is the `docker.io/nextcloud/aio-imaginary:latest-arm64` image. + To do so, you will need to deploy the service and make sure that it is not accessible from outside of your servers. Then you can configure Nextcloud to use Imaginary by editing your `config.php`: @@ -147,6 +150,9 @@ Nextcloud to use Imaginary by editing your `config.php`: ], 'preview_imaginary_url' => 'http://', +.. warning:: + + Make sure to start Imaginary with the `-return-size` command line parameter. Otherwise, there will be a minor performance impact. The flag requires a recent version of Imaginary (newer than v1.2.4) and is by default added to the `aio-imaginary` container. .. note::