mash-playbook/docs/services/radicale.md
2023-03-15 10:58:12 +02:00

1.9 KiB

Radicale

Radicale is a Free and Open-Source CalDAV and CardDAV Server (solution for hosting contacts and calendars).

Dependencies

This service requires the following other services:

Configuration

To enable this service, add the following configuration to your vars.yml file and re-run the installation process:

########################################################################
#                                                                      #
# radicale                                                             #
#                                                                      #
########################################################################

radicale_enabled: true

radicale_hostname: mash.example.com
radicale_path_prefix: /radicale

radicale_credentials:
  - username: someone
    password: secret-password
  - username: another
    password: more-secret-password

########################################################################
#                                                                      #
# /radicale                                                            #
#                                                                      #
########################################################################

In the example configuration above, we configure the service to be hosted at https://mash.example.com/radicale.

You can remove the radicale_path_prefix variable definition, to make it default to /, so that the service is served at https://mash.example.com/.

Usage

After installation, you can log in with your credentials (see the radicale_credentials configuration variable).

Creating new users requires changing the radicale_credentials variable and re-running the playbook. You can rebuild only this service quickly by running: just install-service radicale.