diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bc50bc5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# pyte.dev
+
+Personal blog built with [Hugo](https://gohugo.io) using the [Mana](https://github.com/Livour/hugo-mana-theme) theme.
+
+## Create a new post
+
+```bash
+hugo new content content/posts/my-post-title.md
+```
+
+Set `draft = false` in the frontmatter when ready to publish.
+
+## Deploy
+
+Pushing to the `main` branch triggers a [Gitea Action](.gitea/workflows/deploy.yml) that:
+
+1. Checks out the repo with submodules
+2. Builds the site with `hugo --minify`
+3. Generates the search index with pagefind
+4. Copies the static files via SCP to the server
+5. Sets correct permissions
+
+The site is served by an nginx container with a bind mount to `/opt/docker/website/public`.