From 966104290e496a12050234d2a4d655feb476b90c Mon Sep 17 00:00:00 2001
From: FrederikBaerentsen <frederik+gitea@baerentsen.net>
Date: Mon, 15 Sep 2025 21:27:55 +0200
Subject: [PATCH] Update docs/clients.md

Added info on http for iOS.
---
 docs/clients.md | 58 ++++++++++++++++++++++++++++++-------------------
 1 file changed, 36 insertions(+), 22 deletions(-)

diff --git a/docs/clients.md b/docs/clients.md
index 88929af..918359c 100644
--- a/docs/clients.md
+++ b/docs/clients.md
@@ -1,22 +1,36 @@
-## 📱 Clients
-
-**Supported Clients**
-
-| App                          | Downloads | Search | Streaming | 
-| ---------------------------  | --  | -- | -- | 
-| Panels (iOS)                 | ✔️  |✔️  |✔️  |
-| KyBook 3 (iOS)               | ✔️  | ✔️  | ❌  |
-| Cantook (iOS)                | ✔️  | ❌  | ❌  |
-| Marvin 3 (iOS)                 | ✔️  | ❌  | ❌  |
-| Chunky (iOS)                 | ✔️  | ❌  | ❌  |
-
-### Panels for iOS
-1. Open Panels → Library → Connect Service → OPDS
-2. **URL**: Your OPDS root (e.g., `https://comics.example.com/`)
-3. **Username/Password**: If you enabled Basic Auth
-4. Panels will display covers and use your folder structure for browsing
-
-### Client-Specific Notes
-- Some clients work better with smaller `PAGE_SIZE` (e.g., 25 instead of 50)
-- Page streaming (PSE 1.1) requires client support
-- Thumbnail quality may vary between clients
\ No newline at end of file
+## 📱 Clients
+
+**Supported Clients**
+
+| App                          | Downloads | Search | Streaming | 
+| ---------------------------  | --  | -- | -- | 
+| Panels (iOS)                 | ✔️  |✔️  |✔️  |
+| KyBook 3 (iOS)               | ✔️  | ✔️  | ❌  |
+| Cantook (iOS)                | ✔️  | ❌  | ❌  |
+| Marvin 3 (iOS)                 | ✔️  | ❌  | ❌  |
+| Chunky (iOS)                 | ✔️  | ❌  | ❌  |
+
+### Panels for iOS
+1. Open Panels → Library → Connect Service → OPDS
+2. **URL**: Your OPDS root (e.g., `https://comics.example.com/`)
+3. **Username/Password**: If you enabled Basic Auth
+4. Panels will display covers and use your folder structure for browsing
+
+### Client-Specific Notes
+- Some clients work better with smaller `PAGE_SIZE` (e.g., 25 instead of 50)
+- Page streaming (PSE 1.1) requires client support
+- Thumbnail quality may vary between clients
+
+
+## Notes on Clients and HTTPS
+
+Most OPDS clients (Panels, Marvin, Thorium, Chunky, etc.) work fine over plain `http://` when you are on your local network or connected with a standard VPN (e.g. WireGuard, OpenVPN).  
+
+⚠️ **iOS requirement**: When connecting outside your local network, iOS apps typically require `https://`.  
+This is because of Apple's [App Transport Security (ATS)](https://developer.apple.com/documentation/bundleresources/information-property-list/nsapptransportsecurity) rules, which block insecure external requests.  
+
+- If you use a traditional VPN, you can usually keep using `http://` on the VPN tunnel.  
+- If you use Tailscale, be aware that iOS does not treat Tailscale connections as a "real VPN" and still enforces HTTPS.  
+- The solution is to set up a valid HTTPS certificate (e.g. via Let's Encrypt) and reverse proxy (Traefik, Nginx, Caddy, etc.).
+
+👉 This project does not provide networking or HTTPS setup guides, but be aware that if you plan to access ComicOPDS outside your LAN (or via Tailscale on iOS), you'll need to serve it over HTTPS.