Skip to content

High performance self-hosted photo and video management solution.

fix(docs): info on preloading ML models (#16452)

Matthew Momjiana03e999bdea2
diff --git a/docs/docs/install/environment-variables.md b/docs/docs/install/environment-variables.md
index 16f05b6338..0421eeff38 100644
--- a/docs/docs/install/environment-variables.md
+++ b/docs/docs/install/environment-variables.md
@@ -181,7 +181,11 @@ Redis (Sentinel) URL example JSON before encoding:
:::info
-Other machine learning parameters can be tuned from the admin UI.
+While the `textual` model is the only one required for smart search, some users may experience slow first searches
+due to backups triggering loading of the other models into memory, which blocks other requests until completed.
+To avoid this, you can preload the other models (`visual`, `recognition`, and `detection`) if you have enough RAM to do so.
+
+Additional machine learning parameters can be tuned from the admin UI.
:::