Installing on Docker

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 its origin is this discussion - https://github.com/Kozea/Radicale/discussions/1745

Alternative image with vCard v4.0 support

A third party image supporting vCard 4.0 is available at https://ghcr.io/wutr/radicale-vcardv4-docker and the source for the Docker file and GitHub actions at https://github.com/wutr/radicale-vcardv4-docker. This image is built once a day using GitHub actions, if a newer release of Radicale (compared to the previously built image) is available. It is based on the official release's Docker file. This image is a stop-gap solution until https://github.com/py-vobject/vobject releases v1.0.0 which should include vCard v4.0 support.

Trust

The person behind this auto-built image is https://wwww.github.com/wutr and its origin is this discussion: https://github.com/Kozea/Radicale/discussions/2106

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