From d2ead76c184931e5bc8d83cc26b00031cf17a7b5 Mon Sep 17 00:00:00 2001
From: kalsi-avneet <4151485+kalsi-avneet@users.noreply.github.com>
Date: Thu, 1 Jan 2026 21:37:30 +0000
Subject: [PATCH 1/2] Docker - add compose file

---
 compose.yaml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 compose.yaml

diff --git a/compose.yaml b/compose.yaml
new file mode 100644
index 00000000..2130ee78
--- /dev/null
+++ b/compose.yaml
@@ -0,0 +1,25 @@
+name: Radicale
+services:
+    radicale:
+        image: ghcr.io/kozea/radicale:3.5.10
+        ports:
+        - 5232:5232
+        volumes:
+          - config:/etc/radicale
+          - data:/var/lib/radicale
+
+volumes:
+  config:
+    name: radicale-config
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: ./config
+  data:
+    name: radicale-data
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: ./data

From b58528529bbe9ccf1f7e067706f22e9d37819670 Mon Sep 17 00:00:00 2001
From: kalsi-avneet <4151485+kalsi-avneet@users.noreply.github.com>
Date: Thu, 1 Jan 2026 21:38:52 +0000
Subject: [PATCH 2/2] Docker - documentation for installing Radicale via docker
 compose

---
 DOCUMENTATION.md | 43 ++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 38 insertions(+), 5 deletions(-)

diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index 35c14d36..916e3c95 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -2635,14 +2635,47 @@ You can find the source packages of all releases on
 
 #### Docker
 
-Radicale is available as a [Docker image](https://github.com/Kozea/Radicale/pkgs/container/radicale) for platforms `linux/amd64` and `linux/arm64`. To install the latest version, run:
+Radicale is available as a [Docker image](https://github.com/Kozea/Radicale/pkgs/container/radicale) for platforms `linux/amd64` and `linux/arm64`.
 
-```bash
-docker pull ghcr.io/kozea/radicale:latest
-```
+Here are the steps to install Radicale via Docker Compose:
 
-An example `docker-compose.yml` and detailed instructions will soon be updated.
+1. Create required directories
 
+    Create a directory to store the data, configuration and compose file.
+
+    For example, assuming `./radicale`:
+
+    ```bash
+    $ mkdir radicale
+    $ cd radicale
+    ```
+    Create directories to store data and configuration.
+
+    For example, assuming data directory as `./data` and configuration directory as `./config`:
+
+    ```bash
+    $ mkdir config data
+    ```
+
+2. Download the compose file
+
+    ```bash
+    $ wget https://raw.githubusercontent.com/Kozea/Radicale/refs/heads/master/compose.yaml
+    ```
+
+    The compose file assumes `./config` and `./data` directories. Review the file and modify as needed.
+
+3. Create Radicale configuration file as necessary
+
+    Create new or place existing configuration file in the `./config` directory.
+
+4. Start Radicale
+
+    ```bash
+    $ docker compose up -d
+    ```
+
+    This will start the Radicale container in detached mode.
 
 #### Linux Distribution Packages