You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vincent 88bf320278 update .gitignore 2 months ago
defaults update radicale 1 year ago
files update radicale 1 year ago
handlers init radicale role 2 years ago
meta init radicale role 2 years ago
tasks cirrect encrypt parameter 1 year ago
templates update radicale 1 year ago
tests init radicale role 2 years ago
.drone.yml add task role path to ansible-lint 6 months ago
.gitignore update .gitignore 2 months ago
.markdownlint.yaml add .markdownlint.yaml 6 months ago
.yamllint add .yammlint 6 months ago
README.md init radicale role 2 years ago

README.md

Anarcho-Tech NYC: Radicale Build Status

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.

Configuring Radicale

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:

  1. Simple Radicale server with default for all values:
    radicale_config:
    
  2. 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

The 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_hash key is required.
  • bcrypt_hash: Instead of supplying a password, you can supply a bcrypt hash of the password in passlib format. If this is omitted, the password key is required.
  • state: Whether the user should exist (present) or not (absent). This key is optional.