|vincent 88bf320278||10 months ago|
|defaults||2 years ago|
|files||2 years ago|
|handlers||3 years ago|
|meta||3 years ago|
|tasks||2 years ago|
|templates||2 years ago|
|tests||3 years ago|
|.drone.yml||1 year ago|
|.gitignore||10 months ago|
|.markdownlint.yaml||1 year ago|
|.yamllint||1 year ago|
|README.md||3 years ago|
An Ansible role for installing a Radicale server. Notably, this role has been tested with Raspbian on Raspberry Pi hardware. This role's purpose is to make it simple to install a CalDAV and CardDAV server.
To configure your Radicale server instance, use the
radicale_config dictionary. The keys in this dictionary map nearly one-to-one to the configuration directives described in Radicale's Configuration documentation page. Configuration directive groups are their own dictionaries, and directives that can accept more than one value are specified as a list.
Some examples may prove helpful:
- Simple Radicale server with default for all values:
- Simple Radicale server bound to the local host only and listening on the alternative HTTP port:
radicale_config: server: hosts: - addr: 127.0.0.1 port: 8080
See the comments in the
defaults/main.yaml file for additional details.
Adding or removing Radicale user accounts
radicale_users variable is a list containing dictionaries for each user account. Each user account dictionary in the list can have the following keys:
name: The name of the user account. This key is required.
password: The password for this user account. It is recommended to encrypt this value with Ansible Vault. If this is omitted, the
bcrypt_hashkey is required.
bcrypt_hash: Instead of supplying a password, you can supply a bcrypt hash of the password in
passlibformat. If this is omitted, the
passwordkey is required.
state: Whether the user should exist (
present) or not (
absent). This key is optional.