develop: nextcloud docs

Author: sid115

docs/modules/nixos/nextcloud.md

@@ -43,3 +43,31 @@ nix-shell -p mkpasswd --run 'mkpasswd -sm bcrypt'
 Installing apps via the web interface is disabled. You have to use `services.nextcloud.extraApps`.
 
 Configuring them works as usual in the web interface.
+
+## Maintenance
+
+### Admin CLI
+
+Use Nextcloud's `occ` command for server operations. On NixOS, it is available under the wrapper script `nextcloud-occ`. Refer to the [Nextcloud docs](https://docs.nextcloud.com/server/latest/admin_manual/occ_command.html) on how to use the `occ` command, especially the [Maintenance commands](https://docs.nextcloud.com/server/latest/admin_manual/occ_command.html#maintenance-commands). Here are some useful commands:
+
+- General housekeeping: `sudo nextcloud-occ maintenance:repair --include-expensive`
+
+### Logging
+
+Nextcloud's logs are handled through systemd. Relevant services are:
+
+- `phpfpm-nextcloud.service`: PHP-FPM processes that run the Nextcloud application code - application-level logs
+- `nextcloud-cron.service`: Runs Nextcloud's background jobs and maintenance tasks - cron job execution logs
+- `nginx.service`: Web server that handles HTTP requests - access and connection logs
+
+You can check these logs with:
+
+```bash
+journalctl -u SERVICE
+```
+
+These flags might be useful:
+
+- `-p err`: Show only error-level messages and above
+- `-f`: Follow logs in real-time
+- `--since today`: Show logs from today onwards

modules/nixos/nextcloud/default.nix

@@ -50,7 +50,7 @@ in
       config = {
         adminuser = mkDefault "nextcloud";
         adminpassFile = mkDefault "/etc/secrets/nextcloud-initial-admin-pass";
-        dbtype = mkDefault "sqlite";
+        dbtype = mkDefault "sqlite"; # TODO: switch to postgresql
       };
       configureRedis = mkDefault true;
       extraAppsEnable = mkDefault true;