Skip to content

⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.

docs: say self-hosting needs https and fix the helm note on an api path (#527)

Pasqual Tronconec67029cf77d4
diff --git a/docs/helm.md b/docs/helm.md
index c7e29046..4e3745a6 100644
--- a/docs/helm.md
+++ b/docs/helm.md
@@ -51,8 +51,9 @@ Ingress, TLS certificates, and a ServiceAccount are available but disabled by de
## Ingress
-The API cannot serve behind a path prefix (better-auth mounts at `/api/auth/*` and treats a path inside `API_URL` as a
-replacement for its base path). The chart offers two modes instead.
+The chart routes the API in one of the two modes below. `API_URL` can also be a path on the web's host (see
+[Where the api lives](self-hosting.md#where-the-api-lives)), but then the proxy has to remove that path before the
+request reaches the api. A standard Ingress has no portable way to do that, so the chart does not template this mode.
### Separate host
diff --git a/docs/self-hosting.md b/docs/self-hosting.md
index af60e893..57fa092d 100644
--- a/docs/self-hosting.md
+++ b/docs/self-hosting.md
@@ -2,6 +2,11 @@
Requirements: Docker and a domain behind a TLS-terminating reverse proxy.
+The TLS proxy is required. In production the session cookie is marked `Secure`, and
+browsers do not keep a `Secure` cookie that arrives over plain HTTP: over `http://` the sign-in
+request succeeds, but no session is kept and the app stays signed out. `http://localhost` is the
+one exception in Chrome and Firefox; WebKit browsers such as Safari refuse it there too.
+
```bash
git clone https://github.com/croffasia/itsaplan.git
cd itsaplan