diff --git a/docker-compose.md b/docker-compose.md
index dbafddcf591..709db9e0949 100644
--- a/docker-compose.md
+++ b/docker-compose.md
@@ -301,3 +301,16 @@ user: root
 # specifying both user and group with ids
 user: 0:0
 ```
+### Secrets
+
+```yaml
+# in the container, /run/secrets/my_secret is set to the contents of the file ./my_secret.txt
+services:
+  myapp:
+    image: myapp:latest
+    secrets:
+      - my_secret
+secrets:
+  my_secret:
+    file: ./my_secret.txt
+```
\ No newline at end of file