From 52650497660678ef31476ade50375b833c7eae8d Mon Sep 17 00:00:00 2001
From: Aaron Skarlupka <skarlupkaa@gmail.com>
Date: Wed, 30 Jan 2019 12:06:05 -0600
Subject: [PATCH 1/5] Create docker-compose.yml

This docker-compose.yml file will create a nextcloud instance with signed certs using the lets encrypt companion and the nginx reverse proxy.  Collabora office will also be deployed using signed certs. To use collabora the app must be installed within nextcloud and configured to use office.DOMAIN.TLD.  There is no need to specify a port, simply the pubilc domain used to create your certs for the office instance.  Ports, 443 and 80 should be forwarded to the server.

Signed-off-by: aarskar <aaronskarcode@gmail.com>
---
 .../docker-compose.yml                        | 109 ++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 .examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/docker-compose.yml

diff --git a/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/docker-compose.yml b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/docker-compose.yml
new file mode 100644
index 00000000..b6091b0b
--- /dev/null
+++ b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/docker-compose.yml
@@ -0,0 +1,109 @@
+version: '3' 
+
+services:
+
+  proxy:
+    image: jwilder/nginx-proxy:alpine
+    labels:
+      - "com.github.jrcs.letsencrypt_nginx_proxy_companion.nginx_proxy=true"
+    container_name: nextcloud-proxy
+    networks:
+      - nextcloud_network
+    ports:
+      - 80:80
+      - 443:443
+    volumes:
+      - ./proxy/conf.d:/etc/nginx/conf.d:rw
+      - ./proxy/vhost.d:/etc/nginx/vhost.d:rw
+      - ./proxy/html:/usr/share/nginx/html:rw
+      - ./proxy/certs:/etc/nginx/certs:ro
+      - /etc/localtime:/etc/localtime:ro
+      - /var/run/docker.sock:/tmp/docker.sock:ro
+    restart: unless-stopped
+  
+  letsencrypt:
+    image: jrcs/letsencrypt-nginx-proxy-companion
+    container_name: nextcloud-letsencrypt
+    depends_on:
+      - proxy
+    networks:
+      - nextcloud_network
+    volumes:
+      - ./proxy/certs:/etc/nginx/certs:rw
+      - ./proxy/vhost.d:/etc/nginx/vhost.d:rw
+      - ./proxy/html:/usr/share/nginx/html:rw
+      - /etc/localtime:/etc/localtime:ro
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+    restart: unless-stopped
+  db:
+    image: mariadb
+    container_name: nextcloud-mariadb
+    networks:
+      - nextcloud_network
+    volumes:
+      - db:/var/lib/mysql
+      - /etc/localtime:/etc/localtime:ro
+    environment:
+    # Create a root password for the maraiadb instance.
+      - MYSQL_ROOT_PASSWORD=CREATE-A-SECURE-ROOT-PASSWORD-HERE
+    # Create a password for the nextcloud users.  If you have to manually connect your database you would use the nextcloud user and this password.
+      - MYSQL_PASSWORD=CREATE-A-SECURE-NEXTCLOUD-USER-PASSWORD-HERE
+      - MYSQL_DATABASE=nextcloud
+      - MYSQL_USER=nextcloud
+    restart: unless-stopped
+  
+  app:
+    image: nextcloud:latest
+    container_name: nextcloud-app
+    networks:
+      - nextcloud_network
+    depends_on:
+      - letsencrypt
+      - proxy
+      - db
+    volumes:
+      - nextcloud:/var/www/html
+      - ./app/config:/var/www/html/config
+      - ./app/custom_apps:/var/www/html/custom_apps
+      - ./app/data:/var/www/html/data
+      - ./app/themes:/var/www/html/themes
+      - /etc/localtime:/etc/localtime:ro
+    environment:
+    # The VIRTUAL_HOST and LETSENCRYPT_HOST should use the same publically reachable domain for your nextlcloud instance.
+      - VIRTUAL_HOST=cloud.DOMAIN.TLD
+      - LETSENCRYPT_HOST=cloud.DOMAIN.TLD
+    # This needs to be a real email as it will be used by let's encrypt for your cert and is used to warn you about renewals.
+      - LETSENCRYPT_EMAIL=YOUR-EMAIL@DOMAIN.TDL
+    restart: unless-stopped
+  collab:
+    image: collabora/code
+    container_name: nextcloud-collab
+    networks:
+      - nextcloud_network
+    depends_on:
+      - proxy
+      - letsencrypt
+    cap_add:
+     - MKNOD
+    ports:
+      - 9980:9980
+    environment:
+    # This nees to be the same as what you set your app domain too (ex: cloud.domain.tld).
+      - domain=cloud\\.DOMAIN\\.TDL
+      - username=admin
+    # Create a passoword for the collabora office admin page.
+      - password=CREATE-A-SECURE-PASSWORD-HERE
+      - VIRTUAL_PROTO=https
+      - VIRTUAL_PORT=443
+    # The VIRTUAL_HOST and LETSENCRYPT_HOST should use the same publically reachable domain for your collabora instance (ex: office.domain.tld).
+      - VIRTUAL_HOST=office.DOMAIN.TLD
+      - LETSENCRYPT_HOST=office.DOMAIN.TLD
+    # This needs to be a real email as it will be used by let's encrypt for your cert and is used to warn you about renewals.
+      - LETSENCRYPT_EMAIL=YOUR-EMAIL@DOMAIN.TDL
+    restart: unless-stopped 
+volumes:
+  nextcloud:
+  db: 
+  
+networks:
+  nextcloud_network:

From e6054a4909ee1779a0506181d6750dfb1f4a955a Mon Sep 17 00:00:00 2001
From: Aaron Skarlupka <skarlupkaa@gmail.com>
Date: Wed, 30 Jan 2019 12:06:22 -0600
Subject: [PATCH 2/5] Create README.MD

Signed-off-by: aarskar <aaronskarcode@gmail.com>
---
 .../README.MD                                                    | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 .examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD

diff --git a/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD
new file mode 100644
index 00000000..716256e5
--- /dev/null
+++ b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD
@@ -0,0 +1 @@
+This docker-compose.yml file will create a nextcloud instance with signed certs using the lets encrypt companion and the nginx reverse proxy.  Collabora office will also be deployed using signed certs. To use collabora the app must be installed within nextcloud and configured to use office.DOMAIN.TLD.  There is no need to specify a port, simply the pubilc domain used to create your certs for the office instance.  Ports, 443 and 80 should be forwarded to the server.

From 02e6f4339c0eb74831eca1b946936278fcfeee22 Mon Sep 17 00:00:00 2001
From: Aaron Skarlupka <skarlupkaa@gmail.com>
Date: Wed, 30 Jan 2019 12:11:22 -0600
Subject: [PATCH 3/5] Add files via upload

Signed-off-by: aarskar <aaronskarcode@gmail.com>
---
 .../collaboraOnlineNCSettings.png               | Bin 0 -> 24868 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 .examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/collaboraOnlineNCSettings.png

diff --git a/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/collaboraOnlineNCSettings.png b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/collaboraOnlineNCSettings.png
new file mode 100644
index 0000000000000000000000000000000000000000..1922a88732ee6a3bd56eeecc4610f963f4bb22e8
GIT binary patch
literal 24868
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%0DpHF5$d;nO%+*2Q@KYT-eqnz
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

literal 0
HcmV?d00001


From e381107323a1596fe80e2c6985d6d68d07d43e1d Mon Sep 17 00:00:00 2001
From: Aaron Skarlupka <skarlupkaa@gmail.com>
Date: Wed, 30 Jan 2019 12:17:13 -0600
Subject: [PATCH 4/5] Update README.MD

Signed-off-by: aarskar <aaronskarcode@gmail.com>
---
 .../README.MD                                               | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD
index 716256e5..26dc0b4f 100644
--- a/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD
+++ b/.examples/docker-compose/with-nginx-proxy-self-signed-ssl-collabora-office-mariadb/README.MD
@@ -1 +1,5 @@
-This docker-compose.yml file will create a nextcloud instance with signed certs using the lets encrypt companion and the nginx reverse proxy.  Collabora office will also be deployed using signed certs. To use collabora the app must be installed within nextcloud and configured to use office.DOMAIN.TLD.  There is no need to specify a port, simply the pubilc domain used to create your certs for the office instance.  Ports, 443 and 80 should be forwarded to the server.
+This docker-compose.yml file will create a nextcloud instance with signed certs using the lets encrypt companion and the nginx reverse proxy.  Collabora office will also be deployed using signed certs. To use collabora the app must be installed within nextcloud and configured to use office.DOMAIN.TLD.  
+
+There is no need to specify a port, simply the pubilc domain used to create your certs for the office instance.  Ports, 443 and 80 should be forwarded to the server.
+
+![Callabora Settings](collaboraOnlineNCSettings.png)

From 61fb34da5f1b0f3a3f2356df6c328323cbd8098d Mon Sep 17 00:00:00 2001
From: Josh <josh.t.richards@gmail.com>
Date: Sun, 24 Nov 2024 21:40:34 -0500
Subject: [PATCH 5/5] fix(readme): a few typos and small sentences adjustments

Signed-off-by: Josh <josh.t.richards@gmail.com>
---
 README.md | 34 ++++++++++++++++++----------------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 75c8a9e6..f2def1aa 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ Most Nextcloud Server administrative matters are covered in the official [Nextcl
 maintainers (who are volunteers) remain focused on making the image better (rather than responding solely to one-on-one support issues). (Tip: Some of the maintainers are also regular responders to help requests 
 on the [community help forum](https://help.nextcloud.com/).)
 
-For the image specifically, we provide [some simple deployment examples](https://github.com/nextcloud/docker/?tab=readme-ov-file#running-this-image-with-docker-compose) as well as some more extensive [deployment examples](https://github.com/nextcloud/docker/tree/master/.examples). In addition, the [community help forum](https://help.nextcloud.com/) has a "how-to" section with further examples of other peoples' containerbased Nextcloud stacks.
+For the image specifically, we provide [some simple deployment examples](https://github.com/nextcloud/docker/?tab=readme-ov-file#running-this-image-with-docker-compose) as well as some more extensive [deployment examples](https://github.com/nextcloud/docker/tree/master/.examples). In addition, the [community help forum](https://help.nextcloud.com/) has a "how-to" section with further examples of other peoples' container based Nextcloud stacks.
 
 Below you'll find the main documentation for using this image.
 
@@ -48,7 +48,7 @@ $ docker run -d -p 8080:80 nextcloud
 
 Now you can access Nextcloud at http://localhost:8080/ from your host system.
 
-WARNING: This example is only suitable for limited testing purposes. Please read on to understand how the the image handles storing your data and other aspects you need to establish a full production Nextcloud stack.
+WARNING: This example is only suitable for limited testing purposes. Please read on to understand how the image handles storing your data and other aspects you need to consider to establish a full Nextcloud stack.
 
 
 ## Using the fpm image
@@ -139,10 +139,10 @@ If mounting additional volumes under `/var/www/html`, you should consider:
 - Confirming that [upgrade.exclude](https://github.com/nextcloud/docker/blob/master/upgrade.exclude) contains the files and folders that should persist during installation and upgrades; or
 - Mounting storage volumes to locations outside of `/var/www/html`.
 
-You should note that data inside the main folder (`/var/www/html`) will be overridden/removed during installation and upgrades, unless listed in [upgrade.exclude](https://github.com/nextcloud/docker/blob/master/upgrade.exclude). The additional volumes officially supported are already in that list, but custom volumes will need to be added by you. We suggest mounting custom storage volumes outside of `/var/www/html` and if possible read-only so that making this adjustment is unnecessary. If you must do so, however, you may build a custom image with a modified `/upgrade.exclude` file that incorporates your custom volume(s).
+**Data inside the main folder (`/var/www/html`) will be overridden/removed during installation and upgrades, unless listed in [upgrade.exclude](https://github.com/nextcloud/docker/blob/master/upgrade.exclude).** The additional volumes officially supported are already in that list, but custom volumes will need to be added by you. We suggest mounting custom storage volumes outside of `/var/www/html` and if possible read-only so that making this adjustment is unnecessary. If you must do so, however, you may build a custom image with a modified `/upgrade.exclude` file that incorporates your custom volume(s).
 
 
-## Using the Nextcloud command-line interface (`occ`)
+## Accessing the Nextcloud command-line interface (`occ`)
 
 To use the [Nextcloud command-line interface](https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html) (aka. `occ` command):
 ```console
@@ -172,7 +172,7 @@ The `--private` flag can also be specified, in order to output all configuration
 
 ## Auto configuration via environment variables
 
-The Nextcloud image supports auto configuration of the Nextcloud Server installation via environment variables. You can preconfigure everything that is normally asked for during the Nextcloud Installation Wizard (as well as a few other things). 
+The Nextcloud image supports auto configuration of the Nextcloud Server installation via environment variables. You can preconfigure everything that would otherwise be prompted for by the Nextcloud Installation Wizard (as well as a few other key parameters relevant to initial installation). 
 
 ### Database parameters
 
@@ -232,7 +232,7 @@ You might want to make sure the htaccess is up to date after each container upda
 
 ### Redis Memory Caching
 
-To use Redis for memory caching as well as PHP session, specify the following values and also add a [Redis](https://hub.docker.com/_/redis/) container to your stack. See the [examples](https://github.com/nextcloud/docker/tree/master/.examples) for further instructions.
+To use Redis for memory caching as well as PHP session storage, specify the following values and also add a [Redis](https://hub.docker.com/_/redis/) container to your stack. See the [examples](https://github.com/nextcloud/docker/tree/master/.examples) for further instructions.
 
 - `REDIS_HOST` (not set by default) Name of Redis container
 - `REDIS_HOST_PORT` (default: `6379`) Optional port for Redis, only use for external Redis servers that run on non-standard ports.
@@ -259,9 +259,9 @@ Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/adm
 
 ### Object Storage (Primary Storage)
 
-By default, Nextcloud stores all files `/var/www/html/data/` (or whatever custom data directory you've configured). Nextcloud also allows the use of object storages (like OpenStack 
-Swift or any compatible Amazon S3-implementation) as *Primary Storage*. This semi-replaces the default storage of files in the data directory. Note: This data directory might still be 
-used for compatibility reasons. Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/primary_storage.html) for more information.
+By default, Nextcloud stores all files in `/var/www/html/data/` (or whatever custom data directory you've configured). Nextcloud also allows the use of object storages (like OpenStack 
+Swift or any Amazon S3-compatible implementation) as *Primary Storage*. This semi-replaces the default storage of files in the data directory. Note: This data directory might still be 
+used for compatibility reasons and still needs to exist. Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/primary_storage.html) for more information.
 
 To use an external S3 compatible object store as primary storage, set the following variables:
 - `OBJECTSTORE_S3_BUCKET`: The name of the bucket that Nextcloud should store the data in
@@ -296,7 +296,7 @@ Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/adm
 
 ### PHP Configuration
 
-To customize other PHP limits you can simply change the following variables:
+To customize PHP limits you can change the following variables:
 - `PHP_MEMORY_LIMIT` (default `512M`) This sets the maximum amount of memory in bytes that a script is allowed to allocate. This is meant to help prevent poorly written scripts from eating up all available memory but it can prevent normal operation if set too tight.
 - `PHP_UPLOAD_LIMIT` (default `512M`) This sets the upload limit (`post_max_size` and `upload_max_filesize`) for big files. Note that you may have to change other limits depending on your client, webserver or operating system. Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/big_file_upload_configuration.html) for more information.
 
@@ -304,13 +304,13 @@ To customize other PHP limits you can simply change the following variables:
 
 To customize the Apache max file upload limit you can change the following variable:
 - `APACHE_BODY_LIMIT` (default `1073741824` [1GiB]) This restricts the total
-size of the HTTP request body sent from the client. It specifies the number of _bytes_ that are allowed in a request body. A value of **0** means **unlimited**. Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/big_file_upload_configuration.html#apache) for more information.
+size of the HTTP request body sent from the client. It specifies the number of _bytes_ that are allowed in a request body. A value of **0** means **unlimited**.
 
-Note: Only applicable to the `apache` image variants.
+Check the [Nextcloud documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/big_file_upload_configuration.html#apache) for more information.
 
 ### Using the image behind a reverse proxy and specifying the server host and protocol
 
-The apache image will replace the remote addr (IP address visible to Nextcloud) with the IP address from `X-Real-IP` if the request is coming from a proxy in `10.0.0.0/8`, `172.16.0.0/12` or `192.168.0.0/16` by default. If you want Nextcloud to pick up the server host (`HTTP_X_FORWARDED_HOST`), protocol (`HTTP_X_FORWARDED_PROTO`) and client IP (`HTTP_X_FORWARDED_FOR`) from a trusted proxy, then disable rewrite IP and add the reverse proxy's IP address to `TRUSTED_PROXIES`.
+By default, the apache image will replace the remote addr (IP address visible to Nextcloud) with the IP address from `X-Real-IP` if the request is coming from a reverse proxy in `10.0.0.0/8`, `172.16.0.0/12` or `192.168.0.0/16`. If you want Nextcloud to pick up the server host (`HTTP_X_FORWARDED_HOST`), protocol (`HTTP_X_FORWARDED_PROTO`) and client IP (`HTTP_X_FORWARDED_FOR`) from a trusted proxy, then disable rewrite IP and add the reverse proxy's IP address to `TRUSTED_PROXIES`.
 
 - `APACHE_DISABLE_REWRITE_IP` (not set by default): Set to 1 to disable rewrite IP.
 
@@ -378,7 +378,7 @@ To use the hooks triggered by the `entrypoint` script, either
 ...
 ```
 
-# Running this image with docker compose
+# Running this image with `docker compose`
 The easiest way to get a fully featured and functional setup is using a `compose.yaml` file. There are too many different possibilities to setup your system, so here are only some examples of what you have to look for.
 
 At first, make sure you have chosen the right base image (fpm or apache) and added features you wanted (see below). In every case, you would want to add a database container and docker volumes to get easy access to your persistent data. When you want to have your server reachable from the internet, adding HTTPS-encryption is mandatory! See below for more information.
@@ -432,7 +432,7 @@ Then run `docker compose up -d`, now you can access Nextcloud at http://localhos
 ## Base version - FPM
 When using the FPM image, you need another container that acts as web server on port 80 and proxies the requests to the Nextcloud container. In this example a simple nginx container is combined with the Nextcloud-fpm image and a MariaDB database container. The data is stored in docker volumes. The nginx container also needs access to static files from your Nextcloud installation. It gets access to all the volumes mounted to Nextcloud via the `volumes` option. The configuration for nginx is stored in the configuration file `nginx.conf`, that is mounted into the container. An example can be found in the examples section [here](https://github.com/nextcloud/docker/tree/master/.examples).
 
-This setup provides **no TLS encryption** and is intended to run behind a proxy.
+This setup provides **no TLS encryption** and is intended to run behind a reverse proxy.
 
 Make sure to pass in values for `MYSQL_ROOT_PASSWORD` and `MYSQL_PASSWORD` variables before you run this setup.
 
@@ -570,7 +570,9 @@ We recommend using a reverse proxy in front of your Nextcloud installation. Your
 In our [examples](https://github.com/nextcloud/docker/tree/master/.examples) section we have an example for a fully automated setup using a reverse proxy, a container for [Let's Encrypt](https://letsencrypt.org/) certificate handling, database and Nextcloud. It uses the popular [nginx-proxy](https://github.com/nginx-proxy/nginx-proxy) and [acme-companion](https://github.com/nginx-proxy/acme-companion) containers. Please check the according documentations before using this setup.
 
 # First use
-When you first access your Nextcloud, the setup wizard will appear and ask you to choose an administrator account username, password and the database connection. For the database use `db` as host and `nextcloud` as table and user name. Also enter the password you chose in your `compose.yaml` file.
+When you first access your Nextcloud, the setup wizard will appear and ask you to choose an administrator account username, password and the database connection (unless of course you've provided all the necessary auto-config config values ahead of time). 
+
+For the database use `db` as host and `nextcloud` as table and user name. Also enter the password you chose in your `compose.yaml` file.
 
 # Update to a newer version
 Updating the Nextcloud container is done by pulling the new image, throwing away the old container and starting the new one.