From f70dcaa6cc460cf7f76df97198666eec536fc2eb Mon Sep 17 00:00:00 2001
From: Matthew Momjian <50788000+mmomjian@users.noreply.github.com>
Date: Tue, 27 Aug 2024 11:54:53 -0400
Subject: [PATCH] docs: mTLS/self signed FAQ entry (#12074)

mTLS/self signed
---
 docs/docs/FAQ.mdx                          | 5 +++++
 docs/src/components/community-projects.tsx | 3 ++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/docs/FAQ.mdx b/docs/docs/FAQ.mdx
index 117ca74c03..a5d9b6e3d3 100644
--- a/docs/docs/FAQ.mdx
+++ b/docs/docs/FAQ.mdx
@@ -52,6 +52,11 @@ On iOS (iPhone and iPad), the operating system determines if a particular app ca
 - Disable Background App Refresh for apps that don't need background tasks to run. This will reduce the competition for background task invocation for Immich.
 - Use the Immich app more often.
 
+### Why are features not working with a self-signed cert or mTLS?
+
+Due to limitations in the upstream app/video library, using a self-signed TLS certificate or mutual TLS may break video playback or asset upload (both foreground and/or background).
+We recommend using a real SSL certificate from a free provider, for example [Let's Encrypt](https://letsencrypt.org/).
+
 ---
 
 ## Assets
diff --git a/docs/src/components/community-projects.tsx b/docs/src/components/community-projects.tsx
index 0f9b2b2413..0f30bac60f 100644
--- a/docs/src/components/community-projects.tsx
+++ b/docs/src/components/community-projects.tsx
@@ -75,7 +75,8 @@ const projects: CommunityProjectProps[] = [
   },
   {
     title: 'Immich Power Tools',
-    description: 'An unofficial immich client providing tools to speed up your workflows in Immich to organize your people and albums.',
+    description:
+      'An unofficial immich client providing tools to speed up your workflows in Immich to organize your people and albums.',
     url: 'https://github.com/varun-raj/immich-power-tools',
   },
 ];