Compare commits
2 commits
julianfoad
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
bc4f9eb8f5 | ||
|
|
3d64dcf0c4 |
2 changed files with 21 additions and 43 deletions
|
|
@ -15,9 +15,7 @@ This service requires the following other services:
|
|||
|
||||
## Configuration
|
||||
|
||||
To enable this service, add the following configuration to your `vars.yml` file. This is a minimal example. See also the [Optional Configuration](#optional-configuration) sections below.
|
||||
|
||||
Then proceed with the [Installation](#installation) as described below, noting that it includes pre-install and post-install steps.
|
||||
To enable this service, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:
|
||||
|
||||
```yaml
|
||||
########################################################################
|
||||
|
|
@ -31,10 +29,7 @@ nextcloud_enabled: true
|
|||
nextcloud_hostname: mash.example.com
|
||||
nextcloud_path_prefix: /nextcloud
|
||||
|
||||
nextcloud_initial_admin_username: admin # or a name if using personal accounts for admin
|
||||
nextcloud_initial_admin_password: ''
|
||||
|
||||
# Optional configuration, as described below
|
||||
# KeyDB configuration, as described below
|
||||
|
||||
########################################################################
|
||||
# #
|
||||
|
|
@ -47,38 +42,6 @@ In the example configuration above, we configure the service to be hosted at `ht
|
|||
|
||||
You can remove the `nextcloud_path_prefix` variable definition, to make it default to `/`, so that the service is served at `https://mash.example.com/`.
|
||||
|
||||
You can choose any username/password for the initial account. This account will have [super administrator](https://docs.nextcloud.com/server/30/admin_manual/configuration_user/user_configuration.html#granting-administrator-privileges-to-a-user) privileges, by being a member of the `admin` group, but is not otherwise special or unique.
|
||||
|
||||
## Installation
|
||||
|
||||
Installation of Nextcloud requires two or three steps.
|
||||
|
||||
### Pre-Install
|
||||
|
||||
If you've decided to install a dedicated KeyDB instance for Nextcloud, make sure to first do [installation](../installing.md) for the supplementary inventory host (e.g. `nextcloud.example.com-deps`), before running installation for the main one (e.g. `nextcloud.example.com`).
|
||||
|
||||
### Main Install and Start Services
|
||||
|
||||
Run the [installation](../installing.md) for the main nextcloud host, e.g. `just run-tags install-all,start`.
|
||||
|
||||
Ensure Nextcloud and all services it depends on are installed and started.
|
||||
|
||||
### Post-Install
|
||||
|
||||
After the main installation, and services are running, you need to run a post-install step before Nextcloud will be available to use.
|
||||
|
||||
Run the post-install step: `just run-tags post-install-nextcloud` (or `post-install-all`).
|
||||
|
||||
This post-install step:
|
||||
|
||||
- runs the Nextcloud [initial installation](https://docs.nextcloud.com/server/latest/admin_manual/installation/command_line_installation.html) `occ maintenance:install`, if it hasn't yet run.
|
||||
- adjusts the configuration of URL paths, trusted reverse-proxies, etc.
|
||||
- configures Nextcloud settings including those you define in `nextcloud_config_additional_parameters`.
|
||||
|
||||
Run it again after making any changes.
|
||||
|
||||
## Optional Configuration
|
||||
|
||||
### KeyDB
|
||||
|
||||
KeyDB can **optionally** be enabled to improve Nextcloud performance.
|
||||
|
|
@ -265,6 +228,21 @@ To enable [Samba](https://www.samba.org/) external Windows fileshares using [smb
|
|||
nextcloud_container_image_customizations_samba_enabled: true
|
||||
```
|
||||
|
||||
## Installation
|
||||
|
||||
If you've decided to install a dedicated KeyDB instance for Nextcloud, make sure to first do [installation](../installing.md) for the supplementary inventory host (e.g. `nextcloud.example.com-deps`), before running installation for the main one (e.g. `nextcloud.example.com`).
|
||||
|
||||
## Usage
|
||||
|
||||
After [installation](../installing.md), you should follow Nextcloud's setup wizard at the URL you've chosen.
|
||||
|
||||
You can choose any username/password for your account.
|
||||
|
||||
In **Storage & database**, you should choose PostgreSQL (changing the default **SQLite** choice), with the credentials you see after running `just run-tags print-nextcloud-db-credentials`
|
||||
|
||||
Once you've fully installed Nextcloud, you'd better adjust its default configuration (URL paths, trusted reverse-proxies, etc.) by running: `just run-tags adjust-nextcloud-config`
|
||||
|
||||
|
||||
## Recommended other services
|
||||
|
||||
### Collabora Online
|
||||
|
|
@ -305,7 +283,7 @@ then install Nextcloud (or rerun the playbook if already installed).
|
|||
|
||||
Next, from the Settings/Application menu in your Nextcloud instance install the preview generator app (https://apps.nextcloud.com/apps/previewgenerator).
|
||||
|
||||
After the application is installed run `just run-tags post-install-nextcloud` that will start the original preview-generation and when finished, enables the periodic generation of new images.
|
||||
After the application is installed run `just run-tags adjust-nextcloud-config` that will start the original preview-generation and when finished, enables the periodic generation of new images.
|
||||
|
||||
The original generation may take a long time, but a continuous prompt is presented by ansible as some visual feedback (it is being run as an async task), however it will timeout after approximately 27 hours.
|
||||
|
||||
|
|
@ -317,7 +295,7 @@ If it takes more time to run than a day, you may want to start it from the host
|
|||
/usr/bin/env docker exec mash-nextcloud-server php /var/www/html/occ preview:generate-all
|
||||
```
|
||||
|
||||
Also, please note: every time Nextcloud version is updated, you should rerun: `just run-tags post-install-nextcloud`.
|
||||
Also, please note: every time Nextcloud version is updated, you should rerun: `just run-tags adjust-nextcloud-config`.
|
||||
|
||||
Other supported variables:
|
||||
|
||||
|
|
|
|||
|
|
@ -133,7 +133,7 @@
|
|||
name: funkwhale
|
||||
activation_prefix: funkwhale_
|
||||
- src: git+https://github.com/mother-of-all-self-hosting/ansible-role-gitea.git
|
||||
version: v1.22.2-0
|
||||
version: v1.22.3-0
|
||||
name: gitea
|
||||
activation_prefix: gitea_
|
||||
- src: git+https://github.com/mother-of-all-self-hosting/ansible-role-gotosocial.git
|
||||
|
|
@ -268,7 +268,7 @@
|
|||
name: peertube
|
||||
activation_prefix: peertube_
|
||||
- src: git+https://github.com/mother-of-all-self-hosting/ansible-role-plausible.git
|
||||
version: v2.1.3-0
|
||||
version: v2.1.4-0
|
||||
name: plausible
|
||||
activation_prefix: plausible_
|
||||
- src: git+https://github.com/devture/com.devture.ansible.role.playbook_help.git
|
||||
|
|
|
|||
Loading…
Reference in a new issue