chore(enterprise): Add a copy of Initial Apps selected for Enterprise Train (#3749)

* chore(enterprise): Add a copy of Initial Apps selected for Enterprise Train * removing authelia and freeradius for the time being due to depending on openldap and such * Create README.md Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl> * Create README.md Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl> * Create README.md Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl> * Create README.md Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl> * Create README.md Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl> Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl>
2022-09-24 21:09:58 +02:00
parent 81f222d667
commit edf3f9719f
95 changed files with 14803 additions and 0 deletions
@@ -0,0 +1,68 @@
+---
+sidebar_position: 1
+---
+
+# Installing Traefik
+
+Within TrueCharts, our aim is to make it as easy as possible to secure your Apps.
+To support this, we supply a separate Traefik "ingress" app, which has been pre-configured to provide secure and fast connections.
+
+## How-To
+
+### TrueNAS WebUI
+
+In order to set up Traefik, you will be required to change the default TrueNAS WebUI access ports.
+These ports are by default set to port `80` for HTTP and port `443` for HTTPS.
+This is necessary as we will be setting Traefik up to function as a reverse proxy, and receive traffic on these host ports.
+
+In the TrueNAS Menu, navigate to **System** > **General**. Click the **Settings** button at the top right of the GUI component.
+Under these **GUI Settings**, change:
+
+- Web Interface HTTP Port to port `81`
+- Web Interface HTTPS Port to port `444`.
+
+Click **Save** to save your changes. The WebUI will now prompt you to restart the web server service,
+after which you will be automatically redirected to your dashboard through one of the new ports.
+If you are not prompted to restart the web server service, you may restart the machine and manually navigate
+to the WebUI address followed by one of the new ports eg. `truenas.local:81`.
+
+:::info
+
+These are the recommended ports for this procedure. Using different ports may require some
+changes to your configuration that are not covered in this tutorial.
+
+:::
+
+:::warning
+
+Do not skip this step. Neglecting to change the default ports active may cause your WebUI to become inaccessible after the following step.
+Ensure you are accessing your WebUI from the new ports before proceeding.
+
+:::
+
+### Installing the Traefik Scale App
+
+In the TrueNAS Menu, navigate to **Apps** > **Available Applications**. Use the search bar to search for or manually
+find the Traefik app in the list of apps, and click **Install**
+
+The setup of Traefik is relatively straight-forward. Most of the settings remain unchanged from default, except for these two:
+
+- **Application Name**: Enter a name for your app. You may use simply _traefik_ for this field.
+- **Networking and Services**: Under TCP Services, find and change:
+  - **web Entrypoint Configuration** > **Entrypoints port:**
+    Change port `9080` to port `80`
+  - **websecure Entrypoint Configuration** > **Entrypoints port:**
+    Change port `9433` to port `433`
+
+Continue to section 12, and select **Next**. Traefik will now be installed.
+After installation you can access the Traefik dashboard using your host IP address followed by `:9000`, or by simply clicking "Web Portal" on the application's entry under **Apps** > **Installed Applications**.
+
+:::note
+
+Traefik is part of the `stable` train, so make sure you have it enabled as specified in [Step 1](https://truecharts.org/manual/Quick-Start%20Guides/01-Adding-TrueCharts/) of our Quick Start Guides
+
+:::
+
+## Video Guide
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/bWNPfrKjawI" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen></iframe>
@@ -0,0 +1,44 @@
+# Theme Park
+
+Theme park is a middleware to inject [supported stylesheets (css)](https://docs.theme-park.dev/theme-options)
+into [supported apps](https://docs.theme-park.dev/themes).
+
+So let's see how to do that.
+
+Note that this will only work on apps you have enabled `ingress`, and only when accessing them via the URL.
+Will NOT work if you access them via `IP:PORT`.
+
+## Creating the middleware on traefik
+
+Edit your existing traefik install (or install fresh if you don't have it installed)
+
+- Scroll down to `theme-park`
+- Click <kbd>Add</kbd>
+- Name: `guactheme` (Any name you want, remember it, you will need it later)
+- App Name: `guacamole` (Replace with the name of the app you want to theme)
+- Theme Name: `plex` (Replace wit the theme you want to apply)
+- Base URL: (Leave the default, unless you plan to use a self hosted theme provider)
+- Click <kbd>Save</kbd>
+
+  ![traefik-theme-fields](img/traefik-theme-fields.png)
+
+> Keep in mind that if you decide to use a self hosted theme provider, it will need to have enabled ingress.
+> Also use the external URL, not the internal, as the client will need to access that theme provider to fetch the
+> stylesheets.
+
+## Applying the theme to the app
+
+Edit your existing _App_, in this example we will use `guacamole-client`.
+
+- Scroll down to `Treafik MIddlewares` (Remember, you need to have `ingress` enabled)
+- Click <kbd>Add</kbd>
+- Name: `guactheme` (Replace with the name you gave to your middleware on the previous step)
+- Click <kbd>Save</kbd>
+
+  ![traefik-theme-app](img/traefik-theme-app.png)
+
+You are ready!
+
+|                        Before                         |                        After                        |
+| :---------------------------------------------------: | :-------------------------------------------------: |
+| ![traefik-theme-before](img/traefik-theme-before.png) | ![traefik-theme-after](img/traefik-theme-after.png) |