From e76e3531d7c1881c12aa33101617be6819373833 Mon Sep 17 00:00:00 2001
From: stormbyte <shocker@stormbyte.nl>
Date: Thu, 26 Jun 2025 15:43:51 +0200
Subject: [PATCH 1/3] Update docker.mdx

Add docker compose self build image
---
 docs/integration/docker.mdx | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/docs/integration/docker.mdx b/docs/integration/docker.mdx
index c535580..4c9b888 100644
--- a/docs/integration/docker.mdx
+++ b/docs/integration/docker.mdx
@@ -42,4 +42,39 @@ docker run -p 1337:1337 -e ARGS="--db-url libsql://<db>.turso.io --db-token <tok
 To mount the data directory to the host, you can use the `-v` flag:
 ```bash
 docker run -p 1337:1337 -v /path/to/data:/data bknd
-```
\ No newline at end of file
+```
+
+## Docker compose example
+
+If you want to use docker compose and build the image directly from 
+```yaml
+services:
+  bknd:
+    pull_policy: build
+    build: https://github.com/bknd-io/bknd.git#main:docker
+    ports:
+      - 1337:1337
+    environment:
+      ARGS: "--db-url file:/data/data.db"
+    volumes:
+      - ${DATA_DIR:-.}/data:/data
+```
+
+When you want to build for a specific version
+```yaml
+services:
+  bknd:
+    pull_policy: build
+    build: 
+      context: https://github.com/bknd-io/bknd.git#main:docker
+      args:
+        VERSION: 0.14.0
+      labels:
+        - x-bknd-version=0.14.0
+    ports:
+      - 1337:1337
+    environment:
+      ARGS: "--db-url file:/data/data.db"
+    volumes:
+      - ${DATA_DIR:-.}/data:/data
+```

From a4ddf780ce6966e0fcbd3275cff18c491902a5f8 Mon Sep 17 00:00:00 2001
From: "N.A. Walhof" <niels.walhof@sportunity.nu>
Date: Thu, 3 Jul 2025 15:05:49 +0200
Subject: [PATCH 2/3] Finish the sentences

---
 docs/integration/docker.mdx | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/integration/docker.mdx b/docs/integration/docker.mdx
index 4c9b888..ca3038b 100644
--- a/docs/integration/docker.mdx
+++ b/docs/integration/docker.mdx
@@ -46,7 +46,9 @@ docker run -p 1337:1337 -v /path/to/data:/data bknd
 
 ## Docker compose example
 
-If you want to use docker compose and build the image directly from 
+If you want to use docker compose and build the image directly from the git repository.
+
+`compose.yml`
 ```yaml
 services:
   bknd:
@@ -60,17 +62,22 @@ services:
       - ${DATA_DIR:-.}/data:/data
 ```
 
-When you want to build for a specific version
+The docker compose can be extended to build a specific version of bknd.
+Extend the build command with `args` and `labels`.
+Within the args you can pass a `VERSION` build argument.
+and labels will ensure that the image that has been build a unique identifier has.
+
+`compose.yml`
 ```yaml
 services:
   bknd:
     pull_policy: build
-    build: 
+    build:
       context: https://github.com/bknd-io/bknd.git#main:docker
       args:
-        VERSION: 0.14.0
+        VERSION: <version>
       labels:
-        - x-bknd-version=0.14.0
+        - x-bknd-version=<version>
     ports:
       - 1337:1337
     environment:

From d4076803c6eaed340568b5f4afd5b7110677163c Mon Sep 17 00:00:00 2001
From: dswbx <dennis.senn@gmx.ch>
Date: Thu, 3 Jul 2025 15:15:18 +0200
Subject: [PATCH 3/3] docs: move file name to block, slightly reformulate
 docker compose instructions

---
 docs/integration/docker.mdx | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/docs/integration/docker.mdx b/docs/integration/docker.mdx
index ca3038b..4372cbf 100644
--- a/docs/integration/docker.mdx
+++ b/docs/integration/docker.mdx
@@ -48,8 +48,7 @@ docker run -p 1337:1337 -v /path/to/data:/data bknd
 
 If you want to use docker compose and build the image directly from the git repository.
 
-`compose.yml`
-```yaml
+```yaml compose.yml
 services:
   bknd:
     pull_policy: build
@@ -62,13 +61,12 @@ services:
       - ${DATA_DIR:-.}/data:/data
 ```
 
-The docker compose can be extended to build a specific version of bknd.
-Extend the build command with `args` and `labels`.
-Within the args you can pass a `VERSION` build argument.
-and labels will ensure that the image that has been build a unique identifier has.
 
-`compose.yml`
-```yaml
+The docker compose file can be extended to build a specific version of bknd.
+Extend the `build` section with `args` and `labels`.
+Inside `args`, you can pass a `VERSION` build argument, and use `labels` so the built image receives a unique identifier.
+
+```yaml compose.yml
 services:
   bknd:
     pull_policy: build