diff --git a/docker-compose.prod.yml b/compose.prod.yaml
similarity index 81%
rename from docker-compose.prod.yml
rename to compose.prod.yaml
index 0b0968d..1dfa74c 100644
--- a/docker-compose.prod.yml
+++ b/compose.prod.yaml
@@ -1,10 +1,12 @@
-# docker-compose.prod.yml — production overrides.
+# compose.prod.yaml — production overrides (generic, non-netcup).
 #
 # Use:
-#   docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
+#   docker compose -f compose.yaml -f compose.prod.yaml up -d
+#
+# For the netcup deployment, use `compose.netcup.yaml` instead.
 #
 # Inputs (env or .env file):
-#   LIBRENOTES_IMAGE        registry image, e.g. registry.librete.ch/librenotes:1.2.3
+#   LIBRENOTES_IMAGE        registry image, e.g. git.librete.ch/public/librenotes:v0.1.0
 #   LIBRENOTES_BASE_URL     public origin, e.g. https://librenot.es
 #   LIBRENOTES_JWT_SECRET   secrets manager value, NOT committed
 #   LIBRENOTES_SMTP_HOST    real SMTP host
diff --git a/docker-compose.yml b/compose.yaml
similarity index 95%
rename from docker-compose.yml
rename to compose.yaml
index 0cda183..6353ada 100644
--- a/docker-compose.yml
+++ b/compose.yaml
@@ -1,4 +1,4 @@
-# docker-compose.yml — local development.
+# compose.yaml — local development.
 #
 # Brings up librenotes on http://localhost:8080 with the magic-link
 # mailer logging links to stdout (no SMTP needed). Data lives in