Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

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.

About

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

Resources

License

You can’t perform that action at this time.