Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

docs(preview): document Mailpit SMTP port-forward (#16908)

Max Deichmanne6d3b817e89f
diff --git a/.agents/skills/langfuse-previews/SKILL.md b/.agents/skills/langfuse-previews/SKILL.md
index 0adb22bd23..5e59439142 100644
--- a/.agents/skills/langfuse-previews/SKILL.md
+++ b/.agents/skills/langfuse-previews/SKILL.md
@@ -52,6 +52,11 @@ Pushing updates it; closing the PR tears it down.
(`pr-<N> app preview`, `pr-<N> storybook preview`) — keep that suffix when
editing either comment, or the shortcut disappears. A bare URL is not
matched.
+- **Read captured email** — each preview has an in-namespace Mailpit SMTP
+ sink (invites, password reset, batch-export, spend alerts, mentions). It
+ does not send real mail. The UI is not public; port-forward it:
+ `kubectl -n langfuse-pr-<N> port-forward svc/preview-mailpit 8025:8025`
+ then open `http://localhost:8025`.
- **Know where you are** — every preview page shows a top strip linking back
to the PR, with the author and when the preview content last changed.
- **Update** — push to the PR; it rebuilds and rolls to the new image (~5 min,
diff --git a/.github/workflows/preview-build.yml b/.github/workflows/preview-build.yml
index 589060d57f..a47e70cfaf 100644
--- a/.github/workflows/preview-build.yml
+++ b/.github/workflows/preview-build.yml
@@ -328,6 +328,7 @@ jobs:
```sh
kubectl -n ${{ needs.meta.outputs.namespace }} logs -f deploy/${{ needs.meta.outputs.namespace }}-web # web
kubectl -n ${{ needs.meta.outputs.namespace }} logs -f deploy/${{ needs.meta.outputs.namespace }}-worker # worker
+ kubectl -n ${{ needs.meta.outputs.namespace }} port-forward svc/preview-mailpit 8025:8025 # captured email UI → http://localhost:8025
```
Add `--previous` for a crashed container, `--tail=200` to limit, or
`kubectl -n ${{ needs.meta.outputs.namespace }} get pods` to inspect status.