From 6a83feecd6ef1e29c24a2de3e5749b13c1fb03b8 Mon Sep 17 00:00:00 2001
From: Benoit Chesneau <bchesneau@gmail.com>
Date: Fri, 23 Jan 2026 19:16:40 +0100
Subject: [PATCH] docs: add running in background section to Docker guide

---
 docs/content/guides/docker.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/content/guides/docker.md b/docs/content/guides/docker.md
index 10470aee..e01a6623 100644
--- a/docs/content/guides/docker.md
+++ b/docs/content/guides/docker.md
@@ -20,6 +20,30 @@ Mount your application directory and run:
 docker run -p 8000:8000 -v $(pwd):/app ghcr.io/benoitc/gunicorn app:app
 ```
 
+### Running in Background
+
+Use `-d` (detached mode) to run the container in the background:
+
+```bash
+# Start in background
+docker run -d --name myapp -p 8000:8000 -v $(pwd):/app ghcr.io/benoitc/gunicorn app:app
+
+# View logs
+docker logs myapp
+
+# Follow logs in real-time
+docker logs -f myapp
+
+# Stop the container
+docker stop myapp
+
+# Start it again
+docker start myapp
+
+# Remove the container
+docker rm myapp
+```
+
 ### Environment Variables
 
 | Variable | Description | Default |