diff --git a/README.md b/README.md
index 2bcea05..2dff478 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,39 @@
 # dotnet-android-build-image
+
+Image de build pour le runner Forgejo Yavsc. Debian 12 + .NET SDK 10 +
+workload Android 36 + jq. Source of truth : le `Dockerfile` de ce repo.
+
+## Build (local)
+
+```sh
+sg docker -c "docker build -t pazof/yavsc-build-env:<tag> ."
+```
+
+`<tag>` = `debian12-dotnet10-android36-v<N>` (incrémenter N à chaque
+changement de stack). `sg docker` car le daemon est rootful et l'user
+courant n'est pas dans le groupe Docker de la session de shell.
+
+## Push (Docker Hub)
+
+```sh
+sg docker -c "docker push pazof/yavsc-build-env:<tag>"
+```
+
+Login déjà dans `~/.docker/config.json` (compte `pazof`).
+
+## Alternative CI
+
+Push auto sur push `main` via
+`.github/workflows/docker-publish.yml` (miroir GitHub). Attention :
+le workflow CI tague `:latest` et `:<sha>`, pas notre tag
+`:debian12-…-v<N>` — pour avoir un tag nommé à la main, c'est le
+push local ci-dessus.
+
+## Côté runner Forgejo
+
+Le `runner.labels` du runner doit pointer sur le bon tag pour que
+les jobs `runs-on: docker` le pull. Format :
+
+```yaml
+docker:docker://pazof/yavsc-build-env:debian12-dotnet10-android36-v<N>
+```