Installing on Docker

Official image

There is a Dockerfile at the root of this repository which you can use to build your own Docker image. There is now an officially published Docker image from this file on GitHub docker pull ghcr.io/kozea/radicale:latest. You can find the list of available images here https://github.com/Kozea/Radicale/pkgs/container/radicale. The following Docker tags are published:

• latest
• nightly-{YYYYMMDD} (example nightly-20250720)
• major.minor.patch

Alternative image

There is also a third party automatically built and published Docker image on Docker Hub at https://hub.docker.com/r/grepular/radicale. This image is built automatically once a day if a new version of Radicale has been released, by an automated workflow at this Gitlab repository https://gitlab.com/grepular/docker-radicale. For a given major.minor.patch version release, the following Docker tags are published:

• latest
• major.minor.patch
• major.minor
• major

Trust

The person behind this auto-built image is - https://www.grepular.com / https://github.com/mikecardwell / https://gitlab.com/mikecardwell and it's origin is this discussion - https://github.com/Kozea/Radicale/discussions/1745

Example run using docker command

docker run \
    -p 127.0.0.1:5232:5232 \
    -v "$PWD/config:/etc/radicale" \
    -v "$PWD/data:/var/lib/radicale" \
    ghcr.io/kozea/radicale:latest

Now you should be able to access it at http://127.0.0.1:5232

Example docker-compose.yml file

---
version: "2.1"
services:
  radicale:
    image: ghcr.io/kozea/radicale:3.5.4
    user: root
    ports:
      - "5232:5232"
    volumes:
      - /opt/radicale/config:/etc/radicale:ro
      - /opt/radicale/data:/var/lib/radicale
    restart: unless-stopped

If you wish to build the image locally as part of your docker-compose configuration, you can replace the "image" entry with a "build" entry linking to the official repository:

---
version: "2.1"
services:
  radicale:
    build: "https://github.com/Kozea/Radicale.git#v3.5.4"
    user: root
    ports:
      - "5232:5232"
    volumes:
      - /opt/radicale/config:/etc/radicale:ro
      - /opt/radicale/data:/var/lib/radicale
    restart: unless-stopped