Update docs/clients.md

Added info on http for iOS.

docs/clients.md

@@ -1,22 +1,36 @@
-## 📱 Clients
+## 📱 Clients
-
+
-**Supported Clients**
+**Supported Clients**
-
+
-| App                          | Downloads | Search | Streaming | 
+| App                          | Downloads | Search | Streaming | 
-| ---------------------------  | --  | -- | -- | 
+| ---------------------------  | --  | -- | -- | 
-| Panels (iOS)                 | ✔️  |✔️  |✔️  |
+| Panels (iOS)                 | ✔️  |✔️  |✔️  |
-| KyBook 3 (iOS)               | ✔️  | ✔️  | ❌  |
+| KyBook 3 (iOS)               | ✔️  | ✔️  | ❌  |
-| Cantook (iOS)                | ✔️  | ❌  | ❌  |
+| Cantook (iOS)                | ✔️  | ❌  | ❌  |
-| Marvin 3 (iOS)                 | ✔️  | ❌  | ❌  |
+| Marvin 3 (iOS)                 | ✔️  | ❌  | ❌  |
-| Chunky (iOS)                 | ✔️  | ❌  | ❌  |
+| Chunky (iOS)                 | ✔️  | ❌  | ❌  |
-
+
-### Panels for iOS
+### Panels for iOS
-1. Open Panels → Library → Connect Service → OPDS
+1. Open Panels → Library → Connect Service → OPDS
-2. **URL**: Your OPDS root (e.g., `https://comics.example.com/`)
+2. **URL**: Your OPDS root (e.g., `https://comics.example.com/`)
-3. **Username/Password**: If you enabled Basic Auth
+3. **Username/Password**: If you enabled Basic Auth
-4. Panels will display covers and use your folder structure for browsing
+4. Panels will display covers and use your folder structure for browsing
-
+
-### Client-Specific Notes
+### Client-Specific Notes
-- Some clients work better with smaller `PAGE_SIZE` (e.g., 25 instead of 50)
+- Some clients work better with smaller `PAGE_SIZE` (e.g., 25 instead of 50)
-- Page streaming (PSE 1.1) requires client support
+- Page streaming (PSE 1.1) requires client support
-- Thumbnail quality may vary between clients
+- 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.