chore(docs): Fix broken links for Starlight (#20737)

**Description**
<!--
Please include a summary of the change and which issue is fixed. Please
also include relevant motivation and context. List any dependencies that
are required for this change.
-->
⚒️ Fixes  # <!--(issue)-->

**⚙️ Type of change**

- [ ] ⚙️ Feature/App addition
- [ ] 🪛 Bugfix
- [ ] ⚠️ Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] 🔃 Refactor of current code

**🧪 How Has This Been Tested?**
<!--
Please describe the tests that you ran to verify your changes. Provide
instructions so we can reproduce. Please also list any relevant details
for your test configuration
-->

**📃 Notes:**
<!-- Please enter any other relevant information here -->

**✔️ Checklist:**

- [ ] ⚖️ My code follows the style guidelines of this project
- [ ] 👀 I have performed a self-review of my own code
- [ ] #️⃣ I have commented my code, particularly in hard-to-understand
areas
- [ ] 📄 I have made corresponding changes to the documentation
- [ ] ⚠️ My changes generate no new warnings
- [ ] 🧪 I have added tests to this description that prove my fix is
effective or that my feature works
- [ ] ⬆️ I increased versions for any altered app according to semantic
versioning
- [ ] I made sure the title starts with `feat(chart-name):`,
`fix(chart-name):` or `chore(chart-name):`

** App addition**

If this PR is an app addition please make sure you have done the
following.

- [ ] 🖼️ I have added an icon in the Chart's root directory called
`icon.png`

---

_Please don't blindly check all the boxes. Read them and only check
those that apply.
Those checkboxes are there for the reviewer to see what is this all
about and
the status of this PR with a quick glance._

---------

Signed-off-by: Stavros Kois <47820033+stavros-k@users.noreply.github.com>
Co-authored-by: Stavros Kois <47820033+stavros-k@users.noreply.github.com>
This commit is contained in:
StevenMcElligott 2024-04-14 01:35:59 -04:00 committed by GitHub
parent 7a4a1894bf
commit f8affccb71
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
22 changed files with 32 additions and 34 deletions

View File

@ -94,7 +94,7 @@ Please see [Authelia Rules](./authelia-rules) for more advanced rules.
![TraefikForwardAuth](./img/TraefikForwardAuth.png)
- Name your `forwardauth` something you'll remember, since that's the middleware you'll add to your ingress going forward. Most people use `auth`
- Address: `http://authelia.ix-authelia.svc.cluster.local:9091/api/verify?rd=https://auth.mydomain.com/` and replace the last part based on `mydomain.com`, and if you've changed ports/names you can get that from [`HeavyScript`](/manual/SCALE/guides/getting-started/#heavyscript)
- Address: `http://authelia.ix-authelia.svc.cluster.local:9091/api/verify?rd=https://auth.mydomain.com/` and replace the last part based on `mydomain.com`, and if you've changed ports/names you can get that from [`HeavyScript`](/platforms/scale/guides/getting-started/#heavyscript)
- Check `trustForwardHeader`
- Add the following `authResponseHeaders` (press `Add` 4 times)
- `Remote-User`

View File

@ -6,7 +6,7 @@ This guide will walk you through setting up `clusterissuer`, certificate managem
## Prerequisites
- Ensure you have the `premium` and `system` trains enabled for `TrueCharts` as discussed [here](/manual/SCALE/guides/getting-started#adding-truecharts).
- Ensure you have the `premium` and `system` trains enabled for `TrueCharts` as discussed [here](/platforms/scale/guides/getting-started/#adding-truecharts).
- [Traefik](/charts/premium/traefik/) is installed from premium train
- [Cert-Mananger](/charts/system/cert-manager/) and [Prometheus-Operator](/charts/system/prometheus-operator/)

View File

@ -20,7 +20,7 @@ If you are using two factor authentication on your Nextcloud accounts disable it
### Backup Database
If you have not already done so install PGAdmin and the [tcdbinfo.sh script](/manual/SCALE/guides/sql-export#how-to-list-database-login-info-for-truecharts-apps)
If you have not already done so install PGAdmin and the [tcdbinfo.sh script](/platforms/scale/guides/sql-export/#how-to-list-database-login-info-for-truecharts-apps)
1. Run the tcdbinfo.sh script and take note of the connection info
@ -98,7 +98,7 @@ Wait for Nextcloud to fully deploy before proceeding.
k3s kubectl scale deploy nextcloud -n ix-nextcloud --replicas=0
```
2. Add Nextcloud to PGAdmin as guided in [steps 1 and 2 here](#backup-nextcloud-database).
2. Add Nextcloud to PGAdmin as guided in [steps 1 and 2 here](#backup-database).
3. In PGAdmin right click on the database and select restore as shown below.
<!-- ![pgadmin-restore1](./img/pgadmin-restore1.png) -->
4. Select the database backup you created previously.

View File

@ -4,10 +4,10 @@ title: Installation Notes
## Requirements
1. The Cloudnative-PG operator is required from the `system` train. More information can be found on our [getting started guide](/manual/SCALE/guides/getting-started/#prometheus-and-cnpg-system-app-installations)
1. The Cloudnative-PG operator is required from the `system` train. More information can be found on our [getting started guide](/platforms/scale/guides/getting-started/#prometheus-and-cnpg-system-app-installations)
2. Ingress is required to be configured. The preferred and supported method for ingress is Traefik. More information can be
found on our [getting started guide](/manual/SCALE/guides/getting-started/#traefik-installation-for-ingress--reverse-proxy-support-with-truecharts-apps).
found on our [getting started guide](/platforms/scale/guides/getting-started/#traefik-installation-for-ingress--reverse-proxy-support-with-truecharts-apps).
:::caution SNAPSHOT DIRECTORY VISIBILITY

View File

@ -2,4 +2,4 @@
title: Authelia + LLDAP + Traefik ForwardAuth Setup guide
---
Please refer to the full [Authelia + LLDAP + Traefik ForwardAuth Setup guide](/charts/premium/authelia/Setup-Guide) for a quick guide should take you through the steps necessary to setup `Authelia` as your `forwardAuth` for `Traefik`.
Please refer to the full [Authelia + LLDAP + Traefik ForwardAuth Setup guide](/charts/premium/authelia/setup-guide) for a quick guide should take you through the steps necessary to setup `Authelia` as your `forwardAuth` for `Traefik`.

View File

@ -48,7 +48,7 @@ Ensure you are accessing your WebUI from the new ports before proceeding.
:::note
Traefik is part of the `premium` train, so make sure you have it enabled as specified in the [guide](/manual/SCALE/guides/getting-started#adding-truecharts).
Traefik is part of the `premium` train, so make sure you have it enabled as specified in the [guide](/platforms/scale/guides/getting-started/#adding-truecharts).
:::

View File

@ -12,7 +12,7 @@ This can be applied to other systems but this specific guide has been tested and
## Prerequisites
This guide assumes you're using Traefik as your Reverse Proxy / Ingress provider and have through the configuration listen in our [Quick-Start guides](/docs/manual/SCALE%20Apps/adding-letsencrypt) and/or the [Traefik documents](/charts/premium/traefik/how-to/). Please ensure that you can access your domain properly with Ingress before attempting any further steps.
This guide assumes you're using Traefik as your Reverse Proxy / Ingress provider and have through the configuration listen in our [Quick-Start guides](/platforms/scale/guides/getting-started/) and/or the [Traefik documents](/charts/premium/traefik/how-to/). Please ensure that you can access your domain properly with Ingress before attempting any further steps.
## Authentik Chart Setup

View File

@ -2,7 +2,7 @@
title: Scale App Installation
---
To effortlessly kickstart your journey with bitmagnet, integrate the [TrueCharts catalog](/manual/SCALE/guides/getting-started#adding-truecharts) and proceed with app installation on TrueNAS Scale.
To effortlessly kickstart your journey with bitmagnet, integrate the [TrueCharts catalog](/platforms/scale/guides/getting-started/#adding-truecharts) and proceed with app installation on TrueNAS Scale.
Optionally, you can configure the `TMDB API Key` by following the guidelines outlined [here](https://bitmagnet.io/setup/configuration.html#obtaining-a-tmdb-api-key).

View File

@ -36,7 +36,7 @@ To use cloudreve with aria2, install the [TrueCharts aria2 app](/charts/stable/a
Once aria2 is installed, open cloudreve's webpage and navigate to the Dashboard (Click on profile icon in top right corner -> Dashboard). In the dashboard, select `Nodes` and then click the edit icon beside `Master (Local Machine)`. In the edit dialog, click `Enable` and then fill out the settings:
- RPC Server: find with `heavyscript dns`, and read about internal DNS [here](/manual/SCALE/guides/linking-apps/).
- RPC Server: find with `heavyscript dns`, and read about internal DNS [here](/platforms/scale/guides/linking-apps/).
- RPC Secret: Set the shared secret here. Must also be set in the Aria2 app.
- Absolute Path: Set this to a custom persistent mount that you've created for this cloudreve app, and have also mounted to Aria2.

View File

@ -34,7 +34,7 @@ None necessary, a domain name is recommended for usage but not required.
### Ingress
Recommended for use with a domain name but not required as mentioned above. You can refer to our [Quick-Start Guides](/manual/SCALE/options/ingress) for an overview on using Ingress with your chart.
Recommended for use with a domain name but not required as mentioned above. You can refer to our [Quick-Start Guides](/platforms/scale/options/ingress) for an overview on using Ingress with your chart.
## Support

View File

@ -6,4 +6,4 @@ This chart requires Ingress to be enabled after initial install due to the confi
![image](https://user-images.githubusercontent.com/89483932/174445638-bac32cc8-375f-4fdb-a99f-f8b75a4613e1.png)
Once this is done you can successful add Ingress using the steps outlined inside our [Quick-Start Guide](/manual/SCALE/options/ingress). If you require more help or details please refer to our Discord for help from our Support Staff.
Once this is done you can successful add Ingress using the steps outlined inside our [Quick-Start Guide](/platforms/scale/guides/getting-started/). If you require more help or details please refer to our Discord for help from our Support Staff.

View File

@ -13,7 +13,7 @@ Inspired by Kubernetes DNS, Kubernetes' cluster-internal DNS server, ExternalDNS
- Traefik
- Clusterissuer / Cert-manager installed (vital if exposed externally)
Please follow the [Getting Started](/manual/SCALE/guides/getting-started) guide on the [Truecharts](https://truecharts.org) website.
Please follow the [Getting Started](/platforms/scale/guides/getting-started/) guide on the [Truecharts](https://truecharts.org) website.
## Installation instructions

View File

@ -8,17 +8,17 @@ and our app is a simple way to install it on your TrueNAS SCALE server.
## Requirements
- Jellyfin TrueCharts Chart
- Installation of the TrueCharts Catalog, starting [here](/manual/SCALE/guides/getting-started#adding-truecharts)
- Installation of the TrueCharts Catalog, starting [here](/platforms/scale/guides/getting-started/#adding-truecharts)
## Media Storage
- We recommend having configured your media before installing the chart.
Most people will have their media inside their TrueNAS box,
and for that you can simply follow our [Adding Storage](/manual/SCALE/guides/add-storage)
and for that you can simply follow our [Adding Storage](/platforms/scale/guides/add-storage)
guide to `Add Additional App Storage` to **Jellyfin** for their media folder.
- However some will prefer `NFS Shares` for this storage,
as they may need to share these folders with other users on other
devices outside of TrueNAS, so we recommend following the [using NFS Shares guide](/manual/SCALE/guides/nfs-share/).
devices outside of TrueNAS, so we recommend following the [using NFS Shares guide](/platforms/scale/guides/nfs-share/).
## Install Jellyfin inside TrueNAS SCALE

View File

@ -8,7 +8,7 @@ title: Setup Guide
- Jellyseerr TrueCharts Chart
- Jellyfin TrueCharts Chart
- Installation of the TrueCharts Catalog, starting [here](/manual/SCALE/guides/getting-started#adding-truecharts)
- Installation of the TrueCharts Catalog, starting [here](/platforms/scale/guides/getting-started/#adding-truecharts)
## Install Jellyseerr inside TrueNAS SCALE

View File

@ -2,4 +2,4 @@
title: Authelia + LLDAP + Traefik ForwardAuth Setup guide
---
Please refer to the full [Authelia + LLDAP + Traefik ForwardAuth Setup guide](/charts/premium/authelia/Setup-Guide) for a quick guide should take you through the steps necessary to setup `Authelia` as your `forwardAuth` for `Traefik`.
Please refer to the full [Authelia + LLDAP + Traefik ForwardAuth Setup guide](/charts/premium/authelia/setup-guide) for a quick guide should take you through the steps necessary to setup `Authelia` as your `forwardAuth` for `Traefik`.

View File

@ -5,7 +5,7 @@ title: Setup Guide
## Requirements
- Your 'All integrations' API key from your account on `notifiarr.com`
- Installation of the TrueCharts Catalog, starting [here](/manual/SCALE/guides/getting-started#adding-truecharts)
- Installation of the TrueCharts Catalog, starting [here](/platforms/scale/guides/getting-started/#adding-truecharts)
## Install Notifiarr inside TrueNAS SCALE

View File

@ -12,7 +12,7 @@ Basic setup guide for enabling Organizr authentication on your apps using Traefi
## Prerequisites
This guide assumes you're using Traefik as your Reverse Proxy / Ingress provider and have through the configuration listed in our
[Quick-Start guides](/manual/guides/adding-letsencrypt) and/or the [Traefik documents](/charts/premium/traefik/how-to).
[Quick-Start guides](/platforms/scale/guides/getting-started/) and/or the [Traefik documents](/charts/premium/traefik/how-to).
Please ensure that you can access your domain properly with Ingress before attempting any further steps.
## Organizr App Setup

View File

@ -7,16 +7,14 @@ online archive. Our app is a simple way to install it on your TrueNAS SCALE serv
## Requirements
- Installation of the TrueCharts Catalog, starting [here](/manual/SCALE/guides/getting-started)
- [`Cloudnative-PG`
operator](/manual/SCALE/guides/getting-started/#cnpgprometheus-system-installation-and-migration-guide-for-older-users)
- Installation of the TrueCharts Catalog, starting [here](/platforms/scale/guides/getting-started/) and the required operators (Prometheus-Operator and Cloudnative-PG).
- Paperless-ngx TrueCharts Chart
## Media Storage
- If you plan on importing documents into Paperless-ngx via a network share, for example from a computer or scanner, it
is recommended to set up an `NFS Share` for the shared folder. See the [NFS Shares
guide](/manual/SCALE/guides/nfs-share) for further information.
guide](/platforms/scale/guides/nfs-share) for further information.
## Install Paperless inside TrueNAS SCALE
@ -64,13 +62,13 @@ to a shared folder on your TrueNAS SCALE from your computer or directly from you
up the documents from there. See the explanation of the feature linked above and its [configuration
options](https://docs.paperless-ngx.com/configuration/#consume_config) for more information.
Due to the [Hast Path Validation Safety](/manual/SCALE/guides/add-storage#host-path-validation-safety) checks of TrueNAS
Due to the [Hast Path Validation Safety](/platforms/scale/guides/add-storage/#host-path-validation-safety) checks of TrueNAS
SCALE, using storage for an application on your TrueNAS SCALE and with a network share at the same time requires a bit
of work. See also the [FAQ](/manual/FAQ#why-i-cant-use-host-path-on-both-my-apps-and-sharing-services) regarding this
of work. See also the [FAQ](/general/FAQ/) regarding this
topic.
This guide will only describe the Paperless-ngx specific options required to set up importing documents from a network
share. Please refer to Part 1 of the [NFS shares with TrueChart apps guide](/manual/SCALE/guides/nfs-share) to prepare
share. Please refer to Part 1 of the [NFS shares with TrueChart apps guide](/platforms/scale/guides/nfs-share) to prepare
the NFS share you want to use with Paperless-ngx and note its path. Refer to the [TrueNAS SCALE adding SMB shares
guide](https://www.truenas.com/docs/scale/scaletutorials/shares/smb/addsmbshares/) to set up network sharing of that
same folder for Windows computers or scanners offering this functionality.
@ -99,14 +97,14 @@ in the import share will not be imported anymore though.
### Configure ForwardAuth authentication
Users that have set up [Traefik with ForwardAuth, for example with Authelia](/charts/premium/authelia/Setup-Guide/)
Users that have set up [Traefik with ForwardAuth, for example with Authelia](/charts/premium/authelia/setup-guide/)
can take advantage of authentication through Authelia for their Paperless-ngx installation. Paperless-ngx will honor
logins passed from Authelia but not the e-mail address nor the groups of the logged-in user, those will be internal to
Paperless-ngx and separate from those in Authelia. ForwardAuth can be added to an existing Paperless-ngx installation as
long as the logins of Authelia users match the logins of Paperless-ngx users.
This guide will only describe the Paperless-ngx specific options required to set up ForwardAuth. Please refer to the
[Traefik + Authelia ForwardAuth setup guide](/charts/premium/authelia/Setup-Guide/) on how to prepare ForwardAuth.
[Traefik + Authelia ForwardAuth setup guide](/charts/premium/authelia/setup-guide/) on how to prepare ForwardAuth.
Once you have set up ForwardAuth in your Traefik installation, configure ForwardAuth in Paperless-ngx as follows:

View File

@ -76,7 +76,7 @@ I always mount to the root directory of the container
### VPN
Use the [Gluetun VPN Add-on Setup Guide](/manual/SCALE/guides/vpn-setup)
Use the [Gluetun VPN Add-on Setup Guide](/platforms/scale/guides/vpn-setup/)
<br />

View File

@ -7,7 +7,7 @@ title: Installation Notes
- Enable ingress, without doing so `http://IP:PORT` will be used as the short url generator which obviously will be an issue.
- Please follow this [guide](/manual/SCALE/options/ingress) on adding ingress to a chart.
- Please follow this [guide](/platforms/scale/options/ingress) on adding ingress to a chart.
## Disable authentication

View File

@ -5,7 +5,7 @@ description: A How To Guide for Traefik Forward Auth
:::note
We highly recommend to setup [authelia](/charts/premium/authelia/docs/Setup-Guide.md) instead.
We highly recommend to setup [authelia](/charts/premium/authelia/docs/setup-guide.md) instead.
:::

View File

@ -12,7 +12,7 @@ If you get
> [EFAULT] Failed to install App: Error: INSTALLATION FAILED: rendered manifests contain a resource that already exists. Unable to continue with install: CustomResourceDefinition "alertmanagerconfigs.monitoring.coreos.com" in namespace "" exists and cannot be imported into the current release: invalid ownership metadata; label validation error: missing key "app.kubernetes.io/managed-by": must be set to "Helm"; annotation validation error: missing key "meta.helm.sh/release-name": must be set to "prometheus-operator"; annotation validation error: missing key "meta.helm.sh/release-namespace": must be set to "ix-prometheus-operator"
you should follow instructions from the [FAQ](/manual/FAQ#prometheus-operator) to resolve it
you should follow instructions from the [FAQ](/general/FAQ) to resolve it
### Helm