Radicale: Difference between revisions

From NixOS Wiki
imported>Jicksaw
Update examples to use 'settings' instead of the deprecated 'config'
imported>Klaymore
m Typo, small grammar change, periods at ends of sentences
Line 1: Line 1:
Radicale is a Free and Open-Source CalDAV (calendars, todo-lists) and CardDAV (contacts) Server. For more information about Radicale itself, see https://radicale.org/
Radicale is a Free and Open-Source CalDAV (calendars, todo-lists) and CardDAV (contacts) Server. For more information about Radicale itself, see https://radicale.org/.


This basic configuration will run the server. Note that you might want to allow the port (5232 in this case) on you [https://nixos.org/nixos/manual/index.html#sec-firewall firewall]
This basic configuration will run the server. Note that you might want to allow the port (5232 in this case) on your [https://nixos.org/nixos/manual/index.html#sec-firewall firewall].


<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
Line 10: Line 10:
</syntaxhighlight>
</syntaxhighlight>


The <code>settings</code> is standard Radicale configuration, see https://radicale.org/configuration/
The <code>settings</code> is standard Radicale configuration, see https://radicale.org/configuration/.


== Authentication ==
== Authentication ==


The default authentication mode is <code>None</code> which just allows all usernames and passwords. Other option is to use an Apache htpasswd file for authentication.
The default authentication mode is <code>None</code> which just allows all usernames and passwords. The other option is to use an Apache htpasswd file for authentication.


<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">

Revision as of 18:38, 25 November 2021

Radicale is a Free and Open-Source CalDAV (calendars, todo-lists) and CardDAV (contacts) Server. For more information about Radicale itself, see https://radicale.org/.

This basic configuration will run the server. Note that you might want to allow the port (5232 in this case) on your firewall.

services.radicale = {
  enable = true;
  settings.server.hosts = [ "0.0.0.0:5232" ];
};

The settings is standard Radicale configuration, see https://radicale.org/configuration/.

Authentication

The default authentication mode is None which just allows all usernames and passwords. The other option is to use an Apache htpasswd file for authentication.

services.radicale = {
  enable = true;
  settings = {
    server.hosts = [ "0.0.0.0:5232" ];
    auth = {
      type = "htpasswd";
      htpasswd_filename = "/path/to/htpasswd/file/radicale_users";
      # hash function used for passwords. May be `plain` if you don't want to hash the passwords
      htpasswd_encryption = "bcrypt";
    };
  };
};

See also