inital setup

README.md

@@ -1,2 +1,68 @@
-# compose-nextcloud
+# Basic Nextcloud with MariaDB and Onlyoffice docker-compose config
+* can be run on single node setup or in swarm  
 
+## howto
+### single node
+#### start container
+```bash
+docker compose up -d
+```
+
+#### stop container (and remove)
+```bash
+docker compose down
+```
+
+#### view logs
+```bash
+docker compose logs -f
+```
+
+#### reload config
+```bash
+docker compose restart
+```
+
+### swarm
+#### start aka deploy
+hint: drone fails to start until git auth source is created and set in vars
+```bash
+docker stack deploy -c docker-compose.yml cloud
+```
+
+#### stop container aka stack
+```bash
+docker stack rm cloud
+```
+
+#### view logs
+```bash
+docker service logs cloud_cloud -f
+docker service logs cloud_db -f
+docker service logs cloud_office -f
+```
+
+#### reload config (no downtime if replica 2 or more)
+```bash
+docker service update cloud_cloud
+docker service update cloud_db
+docker service update cloud_office
+```
+
+## example caddy config
+```
+cloud.example.com {
+    reverse_proxy cloud:80
+    encode gzip
+
+    # Service discovery via well-known
+    redir /.well-known/carddav /remote.php/carddav 301
+    redir /.well-known/caldav /remote.php/caldav 301
+}
+office.example.com {
+    reverse_proxy office:80
+}
+```
+
+## config onlyoffice in nextcloud
+comming soon