From 4a36e57e1dff95c991278a23736eb80a9129a99d Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:01:24 +0100 Subject: [PATCH 1/7] add default phone region Signed-off-by: szaimen --- readme.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/readme.md b/readme.md index cb68dcf6..9f0f642d 100644 --- a/readme.md +++ b/readme.md @@ -56,6 +56,9 @@ Only those (if you acces the Mastercontainer Interface internally via port 8080) - `443/TCP`: will be used by the Nextcloud container later on and needs to be open - `3478/TCP` and `3478/UPD`: will be used by the Turnserver inside the Talk container and needs to be open +### How to resolve `Security & setup warnings displays the "missing default phone region" after initial install`? +Simply run the following command: `sudo docker exec -it nextcloud-aio-nextcloud php occ config:system:set default_phone_region --value="yourvalue"`. Of course you need to modify `yourvalue` based on your location. Examples are `DE`, `EN` and `GB`. See this list for more codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements + ### Backup solution Nextcloud AIO provides a local backup solution based on BorgBackup. These backups act as a local restore point in case the installation gets corrupted. From 566c8b2a5d3a5fb5f63ac1160afef9fcd213a6ef Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:04:44 +0100 Subject: [PATCH 2/7] add notice about reverse proxies Signed-off-by: szaimen --- readme.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/readme.md b/readme.md index 9f0f642d..d112aeae 100644 --- a/readme.md +++ b/readme.md @@ -56,6 +56,10 @@ Only those (if you acces the Mastercontainer Interface internally via port 8080) - `443/TCP`: will be used by the Nextcloud container later on and needs to be open - `3478/TCP` and `3478/UPD`: will be used by the Turnserver inside the Talk container and needs to be open +### Are reverse proxies supported? +Reverse proxies are currently not supported.
+You might investigate yourself though how it could made work behind reverse proxies. If you open a PR with that we might consider it then :) + ### How to resolve `Security & setup warnings displays the "missing default phone region" after initial install`? Simply run the following command: `sudo docker exec -it nextcloud-aio-nextcloud php occ config:system:set default_phone_region --value="yourvalue"`. Of course you need to modify `yourvalue` based on your location. Examples are `DE`, `EN` and `GB`. See this list for more codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements From cedfc6fc7217b3f5024666cfb03eca9ce1e536df Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:07:32 +0100 Subject: [PATCH 3/7] add notice how to run occ command Signed-off-by: szaimen --- readme.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/readme.md b/readme.md index d112aeae..a2325fc4 100644 --- a/readme.md +++ b/readme.md @@ -60,6 +60,9 @@ Only those (if you acces the Mastercontainer Interface internally via port 8080) Reverse proxies are currently not supported.
You might investigate yourself though how it could made work behind reverse proxies. If you open a PR with that we might consider it then :) +### How to run `occ` commands? +Simply run the following: `sudo docker exec -it nextcloud-aio-nextcloud php occ your-command`. Of course `your-command` needs to be exchanged with the command that you want to run. + ### How to resolve `Security & setup warnings displays the "missing default phone region" after initial install`? Simply run the following command: `sudo docker exec -it nextcloud-aio-nextcloud php occ config:system:set default_phone_region --value="yourvalue"`. Of course you need to modify `yourvalue` based on your location. Examples are `DE`, `EN` and `GB`. See this list for more codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements From 3bf187cc1a8c4fad5bad3fb67351c4e10da195e9 Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:19:41 +0100 Subject: [PATCH 4/7] add some docs about how to update Signed-off-by: szaimen --- readme.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/readme.md b/readme.md index a2325fc4..776d7c8e 100644 --- a/readme.md +++ b/readme.md @@ -66,6 +66,13 @@ Simply run the following: `sudo docker exec -it nextcloud-aio-nextcloud php occ ### How to resolve `Security & setup warnings displays the "missing default phone region" after initial install`? Simply run the following command: `sudo docker exec -it nextcloud-aio-nextcloud php occ config:system:set default_phone_region --value="yourvalue"`. Of course you need to modify `yourvalue` based on your location. Examples are `DE`, `EN` and `GB`. See this list for more codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements +### How to update the containers? +If we push new containers to `latest`, you will see in the AIO interface below the `containers` section that new container updates were found. In this case, just press `Stop containers` and `Start containers` in order to update the containers. And don't forget to back up the current state of your instance using the built-in backup solution before starting the containers again! Otherwise you won't be able to restore your instance easily if something should break during the update. + +If a new `Mastercontainer` update was found, you'll see an additional section below the `containers` section which shows that a mastercontainer update is available. If so, you can simply press on the button to update the container. + +Additionally, there is a cronjob that runs once a day that checks for container and mastercontainer updates and sends a notification to all Nextcloud admins if a new update was found. + ### Backup solution Nextcloud AIO provides a local backup solution based on BorgBackup. These backups act as a local restore point in case the installation gets corrupted. From 8cfbc102e61a16c8b99e26ce3f06bed82f726c49 Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:25:39 +0100 Subject: [PATCH 5/7] add explanation how to log easily log into the aio interface Signed-off-by: szaimen --- readme.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/readme.md b/readme.md index 776d7c8e..22efe6bc 100644 --- a/readme.md +++ b/readme.md @@ -73,6 +73,9 @@ If a new `Mastercontainer` update was found, you'll see an additional section be Additionally, there is a cronjob that runs once a day that checks for container and mastercontainer updates and sends a notification to all Nextcloud admins if a new update was found. +### How to easily log in to the AIO interface? +If your Nextcloud is running and you are logged in as admin in your Nextcloud, you can easily log in to the AIO interface by opening `https://yourdomain.tld/settings/admin/overview` which will show a button on top that enables you to log in to the AIO interface by just clicking on this button. + ### Backup solution Nextcloud AIO provides a local backup solution based on BorgBackup. These backups act as a local restore point in case the installation gets corrupted. From d2390865e7e4e24dc267422c8aaed8c558853c7f Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:41:50 +0100 Subject: [PATCH 6/7] add some words about how it works Signed-off-by: szaimen --- readme.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/readme.md b/readme.md index 22efe6bc..b8314193 100644 --- a/readme.md +++ b/readme.md @@ -56,8 +56,11 @@ Only those (if you acces the Mastercontainer Interface internally via port 8080) - `443/TCP`: will be used by the Nextcloud container later on and needs to be open - `3478/TCP` and `3478/UPD`: will be used by the Turnserver inside the Talk container and needs to be open +### How does it work? +Nextcloud AIO is inspired by projects like Portainer that allow to manage the docker daemon by talking to the docker socket directly. This concept allows to install only one container with a single command that does the heavy lifting of creating and managing all containers that are needed in order to provide a Nextcloud installation with most features included. It also makes updating a breeze and is not bound to the host system (and its slow updates) anymore as everything is in containers. Additionally, it is very easy to handle from a user perspective because a simple interface for managing your Nextcloud AIO installation is provided. + ### Are reverse proxies supported? -Reverse proxies are currently not supported.
+Reverse proxies are currently because of the above mentioned architecture not supported.
You might investigate yourself though how it could made work behind reverse proxies. If you open a PR with that we might consider it then :) ### How to run `occ` commands? From 102d41793cd64e26e4f1e42cf0a8d149305d00f4 Mon Sep 17 00:00:00 2001 From: szaimen Date: Sat, 4 Dec 2021 16:48:39 +0100 Subject: [PATCH 7/7] move how does it work to the top Signed-off-by: szaimen --- readme.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/readme.md b/readme.md index b8314193..0098032d 100644 --- a/readme.md +++ b/readme.md @@ -44,6 +44,13 @@ If your server has port 80 and 8443 open and you point a domain to your server, https://your-domain-that-points-to-this-server.tld:8443 ## FAQ +### How does it work? +Nextcloud AIO is inspired by projects like Portainer that allow to manage the docker daemon by talking to the docker socket directly. This concept allows to install only one container with a single command that does the heavy lifting of creating and managing all containers that are needed in order to provide a Nextcloud installation with most features included. It also makes updating a breeze and is not bound to the host system (and its slow updates) anymore as everything is in containers. Additionally, it is very easy to handle from a user perspective because a simple interface for managing your Nextcloud AIO installation is provided. + +### Are reverse proxies supported? +Reverse proxies are currently because of the above mentioned architecture not supported.
+You might investigate yourself though how it could made work behind reverse proxies. If you open a PR with that we might consider it then :) + ### Which ports are mandatory to be open? Only those (if you acces the Mastercontainer Interface internally via port 8080): - `443/TCP` for the Nextcloud container @@ -56,13 +63,6 @@ Only those (if you acces the Mastercontainer Interface internally via port 8080) - `443/TCP`: will be used by the Nextcloud container later on and needs to be open - `3478/TCP` and `3478/UPD`: will be used by the Turnserver inside the Talk container and needs to be open -### How does it work? -Nextcloud AIO is inspired by projects like Portainer that allow to manage the docker daemon by talking to the docker socket directly. This concept allows to install only one container with a single command that does the heavy lifting of creating and managing all containers that are needed in order to provide a Nextcloud installation with most features included. It also makes updating a breeze and is not bound to the host system (and its slow updates) anymore as everything is in containers. Additionally, it is very easy to handle from a user perspective because a simple interface for managing your Nextcloud AIO installation is provided. - -### Are reverse proxies supported? -Reverse proxies are currently because of the above mentioned architecture not supported.
-You might investigate yourself though how it could made work behind reverse proxies. If you open a PR with that we might consider it then :) - ### How to run `occ` commands? Simply run the following: `sudo docker exec -it nextcloud-aio-nextcloud php occ your-command`. Of course `your-command` needs to be exchanged with the command that you want to run.