dput-ng: fix eval (#364540)
[NixPkgs.git] / nixos / modules / services / web-apps / davis.md
blob9775d8221b5bf0f92743ec18d0fcfc5b1fe7c7e5
1 # Davis {#module-services-davis}
3 [Davis](https://github.com/tchapi/davis/) is a caldav and carrddav server. It
4 has a simple, fully translatable admin interface for sabre/dav based on Symfony
5 5 and Bootstrap 5, initially inspired by Baïkal.
7 ## Basic Usage {#module-services-davis-basic-usage}
9 At first, an application secret is needed, this can be generated with:
10 ```ShellSession
11 $ cat /dev/urandom | tr -dc a-zA-Z0-9 | fold -w 48 | head -n 1
12 ```
14 After that, `davis` can be deployed like this:
15 ```
17   services.davis = {
18     enable = true;
19     hostname = "davis.example.com";
20     mail = {
21       dsn = "smtp://username@example.com:25";
22       inviteFromAddress = "davis@example.com";
23     };
24     adminLogin = "admin";
25     adminPasswordFile = "/run/secrets/davis-admin-password";
26     appSecretFile = "/run/secrets/davis-app-secret";
27     nginx = {};
28   };
30 ```
32 This deploys Davis using a sqlite database running out of `/var/lib/davis`.