Skip to content

High performance self-hosted photo and video management solution.

docs: Add missing info to asset types and storage locations (#11358)

aviv926536628ad9575
diff --git a/docs/docs/administration/backup-and-restore.md b/docs/docs/administration/backup-and-restore.md
index 3650cbbe07..5c6ae47e43 100644
--- a/docs/docs/administration/backup-and-restore.md
+++ b/docs/docs/administration/backup-and-restore.md
@@ -149,9 +149,21 @@ for more info read the [release notes](https://github.com/immich-app/immich/rele
- Preview images (small thumbnails and large previews) for each asset and thumbnails for recognized faces.
- Stored in `UPLOAD_LOCATION/thumbs/<userID>`.
- **Encoded Assets:**
+
- Videos that have been re-encoded from the original for wider compatibility. The original is not removed.
- Stored in `UPLOAD_LOCATION/encoded-video/<userID>`.
+- **Postgres**
+
+ - The Immich database containing all the information to allow the system to function properly.
+ **Note:** This folder will only appear to users who have made the changes mentioned in [v1.102.0](https://github.com/immich-app/immich/discussions/8930) (an optional, non-mandatory change) or who started with this version.
+ - Stored in `UPLOAD_LOCATION/postgres`.
+
+ :::danger
+ A backup of this folder does not constitute a backup of your database!
+ Follow the instructions listed [here](/docs/administration/backup-and-restore#database) to learn how to perform a proper backup.
+ :::
+
</TabItem>
<TabItem value="Storage Template On" label="Storage Template On">
@@ -187,8 +199,19 @@ When you turn off the storage template engine, it will leave the assets in `UPLO
- Files uploaded through mobile apps.
- Temporarily located in `UPLOAD_LOCATION/upload/<userID>`.
- Transferred to `UPLOAD_LOCATION/library/<userID>` upon successful upload.
+- **Postgres**
+
+ - The Immich database containing all the information to allow the system to function properly.
+ **Note:** This folder will only appear to users who have made the changes mentioned in [v1.102.0](https://github.com/immich-app/immich/discussions/8930) (an optional, non-mandatory change) or who started with this version.
+ - Stored in `UPLOAD_LOCATION/postgres`.
+
+ :::danger
+ A backup of this folder does not constitute a backup of your database!
+ Follow the instructions listed [here](/docs/administration/backup-and-restore#database) to learn how to perform a proper backup.
+ :::
</TabItem>
+
</Tabs>
:::danger
diff --git a/docs/docs/features/facial-recognition.md b/docs/docs/features/facial-recognition.md
index 40453b73eb..de408829ed 100644
--- a/docs/docs/features/facial-recognition.md
+++ b/docs/docs/features/facial-recognition.md
@@ -36,7 +36,7 @@ Face detection sends the generated preview image to the machine learning service
## How Facial Recognition Works
-The facial recognition algorithm we use is derived from DBSCAN, a popular clustering algorithm. It essentially treats each detected face as a point in a graph and aims to group points that are close to each other.
+The facial recognition algorithm we use is derived from [DBSCAN](https://www.youtube.com/watch?v=RDZUdRSDOok), a popular clustering algorithm. It essentially treats each detected face as a point in a graph and aims to group points that are close to each other.
:::note
An important concept is whether something is a _core point_. A core point has a minimum number of points around it within a certain distance. A non-core point can only be assigned to a cluster if it can reach a core point; a non-core point can't be used to extend a cluster even if it's part of one. In Immich, the _Minimum Recognized Faces_ setting controls the threshold to be considered a core point.