/chef-radicale

Installs Radicale (the complete CalDAV and CardDAV server) via pip and configures it

Primary LanguageRubyApache License 2.0Apache-2.0

chef-radicale

Build Status

Description

Installs Radicale (a complete CalDAV and CardDAV server) via pip (and therefore python and pip) and configures it from node['radicale'].

Usage

Use recipe[radicale::default] for installing and configuring Radicale including a Debian init script and logging setup. The default configuration with no attributes set should produce a running Radicale. Advanced setups with authentication and custom rules are supported as well as logrotate support.

No support for SSL key and cert handling yet, use a proxy or write an issue.

No support for installing additionally needed modules yet.

Requirements

Platform

It should work on all systems providing Python and pip.

For supported Chef/Ruby version see Travis.

Recipes

default

The Radicale main configuration will be generated to INI format from node['radicale']['config'] and ships with settings for an example server that you should change for production use.

The Radicale authentication configuration happens in the [auth] section of the main configuration and is transformed in the same manner. Special feature: if you specify a username->password or username->passwordhash mapping in ´node['radicale']['users']´ a htpasswd file will automatically be created at node['radicale']['config']['auth']['htpasswd_filename'] (which defaults to /opt/radicale/users) containing those. You have to declare at least one user for this file to be created.

The Radicale rights configuration happens in the [rights] section of the main configuration and is transformed in the same manner. Special feature: if you specify a hash with the necessary rights information a rights file will automatically be created at node['radicale']['config']['rights']['file'] (which defaults to /opt/radicale/rights) containing those. You have to declare at least one rights section for this file to be created.

The Radicale logging configuration will be generated to INI format from node['radicale']['logging'] and ships with sane production settings that you should not change. These default settings are required for logrotate support.

logrotate

Adds a Radicale specific logrotate configuration when logrotate cookbook is found. No attributes needed.

Example configuration

todo

License

chef-radicale is licensed under the Apache License, Version 2.0. See LICENSE for more information.