From 6240c4d3c554b0e2d9b9929c8f9f51ee47513965 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 16 May 2020 04:37:07 +0000 Subject: [PATCH 1/3] Added Nextcloud page --- .vscode/settings.json | 1 + docs/applications/nextcloud.md | 53 ++++++++++++++++++++++++++++++++++ 2 files changed, 54 insertions(+) create mode 100644 docs/applications/nextcloud.md diff --git a/.vscode/settings.json b/.vscode/settings.json index 6498575f..765c723a 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -16,6 +16,7 @@ "dpkg", "emby", "ffmpeg", + "fqdn", "htpasswd", "httprpc", "irssi", diff --git a/docs/applications/nextcloud.md b/docs/applications/nextcloud.md new file mode 100644 index 00000000..7b788b3a --- /dev/null +++ b/docs/applications/nextcloud.md @@ -0,0 +1,53 @@ +--- +id: nextcloud +title: Nextcloud +sidebar_label: Nextcloud +--- + +A self-hosted file-sharing and collaboration tool. A Dropbox/Google Drive alternative. + +## Installation + +Nextcloud requires nginx to be installed. Please install the dependency first, and then install Nextcloud. + +```bash +sudo box install nginx +sudo box install nextcloud +``` + +## Accessing Nextcloud + +You can access nextcloud at `https:///nextcloud`. + +The installation will automatically create the Nextcloud administrator user using your master username and password. + +## User management + +Nextcloud users are being handled separately to + +At the time of writing, `box` **will not** create Nextcloud accounts for your other users. Please create those manually through the administrator interface. + +## Service control + +Nextcloud is an application written by PHP, and therefore it does not have its own service, as it is powered by the PHP-FPM stack. + +## Troubleshooting + +### Domain is not in "trusted domains" +Nextcloud requires to know which domains/IPs/host names it should expect traffic from for security reasons. It will give you an error when it is being accessed from a source it does not recognize. + +Box attempts to guess these based on your IP, your machine's hostname and the value it has for the FQDN, as well as the `server_name` value in your nginx configuration, and adds all of those to the "trusted domains" key. + +You can manually change these by following the commands below. Please note: the values are stored in an array, and the value must be set to the index you desire it to be on. Therefore if you have 6 entries, you should add your domain to the 7th position. + +```bash +cd /srv/nextcloud +# Show all the values currently configured +sudo -u www-data php occ config:system:get trusted_domains +# Get the current amount of entries +sudo -u www-data php occ config:system:get trusted_domains | wc -l +# Set your value to the next index, e.g. = 7 +sudo -u www-data php occ config:system:set trusted_domains --value="" +``` + +You should be able to connect to your instance now. \ No newline at end of file From b248e4d6f96978acb84582feb47a0b53356c3da9 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 16 May 2020 06:42:46 +0000 Subject: [PATCH 2/3] Added the user management lines. --- docs/applications/nextcloud.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/applications/nextcloud.md b/docs/applications/nextcloud.md index 7b788b3a..b4e70b82 100644 --- a/docs/applications/nextcloud.md +++ b/docs/applications/nextcloud.md @@ -23,9 +23,9 @@ The installation will automatically create the Nextcloud administrator user usin ## User management -Nextcloud users are being handled separately to +Nextcloud manages its users in its own database. `box` will create, delete and change passwords in it for you when you make those changes. This only works in the box -> nextcloud direction, which means changing a password in nextcloud will not have an impact on the rest of the system. -At the time of writing, `box` **will not** create Nextcloud accounts for your other users. Please create those manually through the administrator interface. +You can however make Nextcloud users for non-`box`-based users as well through the administration portal. ## Service control From 07e5b7b2e2f5a1776f251d8ac841f8495b054026 Mon Sep 17 00:00:00 2001 From: Flying Sausages Date: Tue, 27 Oct 2020 17:30:24 +0100 Subject: [PATCH 3/3] Move nextcloud into mdx --- docs/applications/nextcloud.md | 53 --------------------------------- docs/applications/nextcloud.mdx | 52 ++++++++++++++++++++++++++++++-- 2 files changed, 49 insertions(+), 56 deletions(-) delete mode 100644 docs/applications/nextcloud.md diff --git a/docs/applications/nextcloud.md b/docs/applications/nextcloud.md deleted file mode 100644 index b4e70b82..00000000 --- a/docs/applications/nextcloud.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -id: nextcloud -title: Nextcloud -sidebar_label: Nextcloud ---- - -A self-hosted file-sharing and collaboration tool. A Dropbox/Google Drive alternative. - -## Installation - -Nextcloud requires nginx to be installed. Please install the dependency first, and then install Nextcloud. - -```bash -sudo box install nginx -sudo box install nextcloud -``` - -## Accessing Nextcloud - -You can access nextcloud at `https:///nextcloud`. - -The installation will automatically create the Nextcloud administrator user using your master username and password. - -## User management - -Nextcloud manages its users in its own database. `box` will create, delete and change passwords in it for you when you make those changes. This only works in the box -> nextcloud direction, which means changing a password in nextcloud will not have an impact on the rest of the system. - -You can however make Nextcloud users for non-`box`-based users as well through the administration portal. - -## Service control - -Nextcloud is an application written by PHP, and therefore it does not have its own service, as it is powered by the PHP-FPM stack. - -## Troubleshooting - -### Domain is not in "trusted domains" -Nextcloud requires to know which domains/IPs/host names it should expect traffic from for security reasons. It will give you an error when it is being accessed from a source it does not recognize. - -Box attempts to guess these based on your IP, your machine's hostname and the value it has for the FQDN, as well as the `server_name` value in your nginx configuration, and adds all of those to the "trusted domains" key. - -You can manually change these by following the commands below. Please note: the values are stored in an array, and the value must be set to the index you desire it to be on. Therefore if you have 6 entries, you should add your domain to the 7th position. - -```bash -cd /srv/nextcloud -# Show all the values currently configured -sudo -u www-data php occ config:system:get trusted_domains -# Get the current amount of entries -sudo -u www-data php occ config:system:get trusted_domains | wc -l -# Set your value to the next index, e.g. = 7 -sudo -u www-data php occ config:system:set trusted_domains --value="" -``` - -You should be able to connect to your instance now. \ No newline at end of file diff --git a/docs/applications/nextcloud.mdx b/docs/applications/nextcloud.mdx index 0046f5aa..8ebb7983 100644 --- a/docs/applications/nextcloud.mdx +++ b/docs/applications/nextcloud.mdx @@ -4,8 +4,54 @@ title: Nextcloud sidebar_label: Nextcloud --- -Nextcloud is an open source, self-hosted file sync and share and communication app platform. Access & sync your files, contacts, calendars & communicate and collaborate across your devices. You decide what happens with your data, where it is and who can access it! +A self-hosted file-sharing and collaboration tool. A Dropbox/Google Drive alternative. -import MissingDocs from '../snippets/missingdocs.md'; +## Installation - \ No newline at end of file +Nextcloud requires nginx to be installed. Please install the dependency first, and then install Nextcloud. + +```bash +sudo box install nginx +sudo box install nextcloud +``` + +## Accessing Nextcloud + +You can access nextcloud at `https:///nextcloud`. + +The installation will automatically create the Nextcloud administrator user using your master username and password. + +## User management + +Nextcloud manages its users in its own database. `box` will create, delete and change passwords in it for you when you make those changes. This only works in the box -> nextcloud direction, which means changing a password in nextcloud will not have an impact on the rest of the system. + +You can however make Nextcloud users for non-`box`-based users as well through the administration portal. + +## Service control + +Nextcloud is an application written by PHP, and therefore it does not have its own service, as it is powered by the PHP-FPM stack. + +## Troubleshooting + +import Troubleshooting from '../snippets/troubleshooting.md'; + + + +### Domain is not in "trusted domains" +Nextcloud requires to know which domains/IPs/host names it should expect traffic from for security reasons. It will give you an error when it is being accessed from a source it does not recognize. + +Box attempts to guess these based on your IP, your machine's hostname and the value it has for the FQDN, as well as the `server_name` value in your nginx configuration, and adds all of those to the "trusted domains" key. + +You can manually change these by following the commands below. Please note: the values are stored in an array, and the value must be set to the index you desire it to be on. Therefore if you have 6 entries, you should add your domain to the 7th position. + +```bash +cd /srv/nextcloud +# Show all the values currently configured +sudo -u www-data php occ config:system:get trusted_domains +# Get the current amount of entries +sudo -u www-data php occ config:system:get trusted_domains | wc -l +# Set your value to the next index, e.g. = 7 +sudo -u www-data php occ config:system:set trusted_domains --value="" +``` + +You should be able to connect to your instance now. \ No newline at end of file