diff --git a/Home.md b/Home.md
index e69de29..60314ea 100644
--- a/Home.md
+++ b/Home.md
@@ -0,0 +1,28 @@
+# maubot-media
+
+Maubot plugin: Matrix companion to the homelab media stack — Seerr, Emby, Sonarr, Radarr, NZBGet, qBittorrent.
+
+This wiki is intentionally sparse — the canonical operational doc lives in the homelab wiki:
+
+> **📖 [clustered-fucks wiki → Media Bot](https://git.3ddbrewery.com/maddox/clustered-fucks/wiki/Media-Bot)**
+
+That page covers commands, webhooks, daily digest, deploy flow, secrets, known gaps, and architecture.
+
+## Repo conventions
+
+- **Plugin ID:** `com.3ddbrewery.media`
+- **Bot user:** `@mediabot:fails.me`
+- **Local working copy:** `~/maubot-media/` on the control server
+- **Build:** `zip -rq com.3ddbrewery.media-vX.Y.Z.mbp maubot.yaml base-config.yaml media_bot/ README.md LICENSE -x '*/__pycache__/*'`
+- **Hot reload:** upload via maubot UI or `POST /v1/plugins/upload?allow_override=true`. Container is **not** restarted.
+
+## Manifest must include
+
+```yaml
+config: true
+extra_files: [base-config.yaml]
+database: true        # required for !media subscribe + digest state
+webapp: true          # required for the @web.post(...) webhook routes
+```
+
+Forgetting `webapp: true` → routes return 404. Forgetting `database: true` → `self.database` is None.