Skip to content

Commit e76a25c

Browse files
committed
20220327 NextCloud documentation
Repairs broken internal hyperlinks by restoring internal anchors. Restored anchors converted to null-anchor form. Signed-off-by: Phill Kelley <[email protected]>
1 parent 9cc8533 commit e76a25c

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

docs/Containers/NextCloud.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Nextcloud
22

3-
## Service definition
3+
## <a name="serviceDefinition"></a>Service definition
44

55
This is the **core** of the IOTstack Nextcloud service definition:
66

@@ -54,7 +54,7 @@ Under new-menu, the menu can generate random passwords for you. You can either u
5454

5555
The passwords need to be set before you bring up the Nextcloud service for the first time but the following initialisation steps assume you might not have done that and always start over from a clean slate.
5656

57-
## Initialising Nextcloud
57+
## <a name="initialisation"></a>Initialising Nextcloud
5858

5959
1. Be in the correct directory:
6060

@@ -108,7 +108,7 @@ The passwords need to be set before you bring up the Nextcloud service for the f
108108

109109
* You **can't** use a multicast domain name (eg `myrpi.local`). An mDNS name will not work until Nextcloud has been initialised!
110110
* Once you have picked a connection method, **STICK TO IT**.
111-
* You are only stuck with this restriction until Nextcloud has been initialised. You **can** (and should) fix it later by completing the steps in ["Access through untrusted domain"](#access-through-untrusted-domain).
111+
* You are only stuck with this restriction until Nextcloud has been initialised. You **can** (and should) fix it later by completing the steps in ["Access through untrusted domain"](#untrustedDomain).
112112

113113
7. On a computer that is **not** the Raspberry Pi running Nextcloud, launch a browser and point to the Raspberry Pi running Nextcloud using your chosen connection method. Examples:
114114

@@ -174,7 +174,7 @@ The passwords need to be set before you bring up the Nextcloud service for the f
174174

175175
![Dashboard](./images/nextcloud-dashboard.png)
176176

177-
## <a name="untrustedDomain">"Access through untrusted domain"</a>
177+
## <a name="untrustedDomain"></a>"Access through untrusted domain"
178178

179179
During Nextcloud initialisation you had to choose between an IP address, a domain name or a host name. Now that Nextcloud is running, you have the opportunity to expand your connection options.
180180

@@ -243,7 +243,7 @@ See also:
243243

244244
* [Nextcloud documentation - trusted domains](https://docs.nextcloud.com/server/21/admin_manual/installation/installation_wizard.html#trusted-domains).
245245

246-
### Using a DNS alias for your Nextcloud service
246+
### <a name="dnsAlias"></a>Using a DNS alias for your Nextcloud service
247247

248248
The examples above include using a DNS alias (a CNAME record) for your Nextcloud service. If you decide to do that, you may see this warning in the log:
249249

@@ -257,17 +257,17 @@ You can silence the warning by editing the Nextcloud service definition in `dock
257257
hostname: nextcloud.mydomain.com
258258
```
259259

260-
## <a name="security"> Security considerations</a>
260+
## <a name="security"></a>Security considerations
261261

262262
Nextcloud traffic is not encrypted. Do **not** expose it to the web by opening a port on your home router. Instead, use a VPN like Wireguard to provide secure access to your home network, and let your remote clients access Nextcloud over the VPN tunnel.
263263

264-
## Container health check
264+
## <a name="healthCheck"></a>Container health check
265265

266266
A script , or "agent", to assess the health of the MariaDB container has been added to the *local image* via the *Dockerfile*. In other words, the script is specific to IOTstack.
267267

268268
Because it is an instance of MariaDB, Nextcloud_DB inherits the health-check agent. See the [IOTstack MariaDB](MariaDB.md) documentation for more information.
269269

270-
## Keeping Nextcloud up-to-date
270+
## <a name="updatingNextcloud"></a>Keeping Nextcloud up-to-date
271271

272272
To update the `nextcloud` container:
273273

@@ -290,7 +290,7 @@ $ docker system prune
290290

291291
The first "prune" removes the old *local* image, the second removes the old *base* image. Whether an old *base image* exists depends on the version of `docker-compose` you are using and how your version of `docker-compose` builds local images.
292292

293-
## Backups
293+
## <a name="backups"></a>Backups
294294

295295
Nextcloud is currently excluded from the IOTstack-supplied backup scripts due to its potential size.
296296

0 commit comments

Comments
 (0)