https://github.com/cupcakearmy/docker-radicale

Docker Radicale Image
https://github.com/cupcakearmy/docker-radicale

caldav carddav docker docker-radicale radicale

Last synced: about 1 year ago
JSON representation

Docker Radicale Image

• Host: GitHub
• URL: https://github.com/cupcakearmy/docker-radicale
• Owner: cupcakearmy
• License: mit
• Created: 2021-03-16T23:12:50.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-08-09T12:54:04.000Z (almost 2 years ago)
• Last Synced: 2025-03-28T20:12:12.802Z (over 1 year ago)
• Topics: caldav, carddav, docker, docker-radicale, radicale
• Language: Dockerfile
• Homepage:
• Size: 95.7 KB
• Stars: 22
• Watchers: 2
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Docker Radicale

This is a small docker image for [Radicale](https://github.com/Kozea/Radicale) and easy deployment. Bcrypt authentication inclusive.

![Docker Pulls](https://img.shields.io/docker/pulls/cupcakearmy/radicale?style=flat-square)

![Docker Image Size (tag)](https://img.shields.io/docker/image-size/cupcakearmy/radicale/latest?style=flat-square)

![Docker Image Version (tag latest semver)](https://img.shields.io/docker/v/cupcakearmy/radicale/latest?style=flat-square)

## Installation

```sh

# .env

USER=foo

PASSWORD=secret

```

```yaml

# docker-compose.yml

version: '3.8'

services:

  app:

    image: cupcakearmy/radicale:1

    restart: unless-stopped

    env_file: .env

    volumes:

      - ./data:/data

    ports:

      - 80:5232

```

The env file is not strictly required, but will generate a user with its bcrypt password if missing.

## macOS Setup

Without SSL/TLS the native client seems to have problems, once SSL is enabled it works like a charm.

![macOS Setup](.github/macOS.png)

The same setup works for Calendar and on iOS.

## Traefik

An example for traefik (v1) can found below.

```yaml

version: '3.8'

networks:

  proxy:

    external: true

services:

  app:

    image: cupcakearmy/radicale:1

    restart: unless-stopped

    env_file: .env

    volumes:

      - ./data:/data

    networks:

      - proxy

    labels:

      - traefik.enable=true

      - traefik.http.routers.radicale.rule=Host(`radicale.example.org`)

      - traefik.http.routers.radicale.entrypoints=secure

      - traefik.http.routers.radicale.tls.certresolver=le

```

## Customize

### Config

You can overwrite the config by simply mounting it into `/etc/radicale/config`.

### User Auth

The default script only creates a default user with the given `USER` and `PASSWORD` credentials. For multiple users you need to create the files manually. In the default config this is set to `/data/users`.

You can add users with `htpasswd -bB -c /data/users user pass`. And then mount that file to `/data/users` or whatever you have set in the Radicale config file `filesystem_folder`, [more here](https://radicale.org/3.0.html#documentation/configuration/auth/htpasswd_filename).