Skip to content

High performance self-hosted photo and video management solution.

docs: mTLS/self signed FAQ entry (#12074)

Matthew Momjianf70dcaa6cc46
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',
},
];