From ca81485595eed58247b64fdb5b77ba2e8e78c4f5 Mon Sep 17 00:00:00 2001
From: phil <phil@systemausfall.org>
Date: Tue, 26 Jul 2022 16:53:28 +0200
Subject: [PATCH] nextcloud: Erstelle README

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..44c9c48
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+Nextcloud
+=========
+
+Diese Rolle installiert [Nextcloud](https://nextcloud.com). Sie umfasst:
+
+- Einrichtung der Datenbank
+- Installation und Ersteinrichtung von Nextcloud
+- Anlegen eines Zertifikates + Konfigurarion des Reverse Proxies
+- Anlegen eines PHP-FPM-Master-Prozesses mit socket activation
+
+# Neue Nextcloud-Instanz anlegen
+
+- Trage die Informationen zur neuen Instanz in `host_vars/sl-nextcloud.kahlo.yaml` ein:
+  | Variable | Wert | Beschreibung |
+  |----------|------|--------------|
+  | `name` | string | Domain-Name der Instanz |
+  | `alias`| string | Array mit weiteren Domain-Alias-Namen für diese Instanz |
+  | `user` | string | Name eines anzulegenden Systemnutzers, der den PHP-FPM-Prozess ausführt |
+  | `database` | string | Name der anzulegenden MariaDB-Datenbank |
+- Starte anschließend das Playbook:
+  ```Shell
+  ansible-playbook playbooks/nextcloud.yml
+  ```
+
+# Aktualisierung des Cores/ von Apps
+
+Mit dem Skript `nextcloud-updater` können alle Nextcloud-Instanzen und die installierten Apps gleichzeitig aktualisiert werden.