develop: radicale docs

Author: sid115

docs/modules/nixos/radicale.md

@@ -0,0 +1,52 @@
+# Radicale
+
+A simple CalDAV and CardDAV server.
+
+View the [*nix-core* NixOS module on GitHub](https://github.com/sid115/nix-core/tree/master/modules/nixos/radicale).
+
+## References
+
+- [Documentation](https://radicale.org/v3.html#documentation-1)
+- [Wiki](https://github.com/Kozea/Radicale/wiki)
+- [GitHub](https://github.com/Kozea/Radicale)
+
+## Sops
+
+Provide every user's SHA512 hashed password to your host's `secrets.yaml`:
+
+> Replace `abc123` with your actual secrets
+
+```yaml
+radicale:
+    user1: abc123
+    user2: abc123
+    # ...
+```
+
+Generate hashed passwords with:
+
+```sh
+nix-shell -p openssl --run 'passwd -6 <password>'
+```
+
+## Setup
+
+Set a CNAME record for your Radicale subdomain (`dav` by default) pointing to your domain.
+
+## Config
+
+```nix
+{ inputs, ... }:
+
+{
+  imports = [ inputs.core.nixosModules.radicale ];
+
+  services.radicale = {
+    enable = true;
+    users = [
+      "user1"
+      "user2"
+    ];
+  };
+}
+```

mkdocs.yml

@@ -60,6 +60,7 @@ nav:
       - open-webui: modules/nixos/open-webui.md
       - peertube: modules/nixos/peertube.md
       - print-server: modules/nixos/print-server.md
+      - radicale: modules/nixos/radicale.md
       - rss-bridge: modules/nixos/rss-bridge.md
       - searx: modules/nixos/searx.md
       - sops: modules/nixos/sops.md

modules/nixos/radicale/default.nix

@@ -5,9 +5,6 @@
   ...
 }:
 
-# Generate passwords with:
-# openssl passwd -6 "password"
-
 let
   cfg = config.services.radicale;
   domain = config.networking.domain;
@@ -74,6 +71,10 @@ in
       enableACME = cfg.forceSSL;
     };
 
+    environment.systemPackages = [
+      pkgs.openssl
+    ];
+
     sops =
       let
         owner = "radicale";
@@ -98,9 +99,5 @@ in
         secrets = mkSecrets cfg.users;
         templates."radicale/users" = mkTemplate cfg.users;
       };
-
-    environment.systemPackages = [
-      pkgs.openssl
-    ];
   };
 }