Merge pull request #198 from pitschi/network-controller-initial

Author: manuel-rw

docs/integrations/network.mdx

@@ -0,0 +1,47 @@
+---
+title: Network
+tags:
+  - Integrations
+  - Configuration
+  - Network
+  - Unifi Controller
+---
+
+# Network
+
+Homarr allows the integration of network controllers to display their stats.
+Multiple network controllers can be added at the same time.
+
+## Unifi Controller
+The Unifi Controller integration enables you to see basic stats with the help of the [Network Controller widget](/docs/next/widgets/network-controller). It is created to support the normal and pro variants of the Unifi Controller.
+
+It is used to show some metrics like www ping, the number of users in different kinds of networks like LAN and WiFi.
+
+For a successful integration you have to make sure of the following:
+
+* Remember that the internal address should not have a path, only the fqdn on SSL (``https://unifi.local``). In this case it would mean to remove anything of the likes of "`/api`" from the link you would usually use.
+* Since the Unifi Controller only runs on SSL, it usually creates a self-signed certificate on the fqdn `unifi.local`. You will have to: 
+  * put in your own certificate into the Unifi Controller if you use another fqdn 
+  * **OR**
+  * make sure your Unifi Controller can be reached through the fqdn `unifi.local` 
+  * get your certificate from the Unifi Controller with a browser by downloading it
+  * [add the certificate](/docs/management/certificates) to the Homarr instance
+* You have to create a user (can be *Restrict*ed *to Local Access Only*) with at least the following permissions:
+  * Network: Full Management
+  * Control Plane: View Only
+
+**NOTICE**: The integration does currently **NOT** support the "*Unifi Network API*" with the "*Control Plane API keys*".
+
+<details>
+  <summary>
+  Available configuration options
+  </summary>
+  <div>
+  
+| Field    | Type    | Description |
+| -------- | ------- | ----------- |
+| Username | Public | Username used for authentication |
+| Password | Private | Password used for authentication |
+
+  </div>
+</details>

docs/widgets/network-controller/img/screenshot.png

@@ -0,0 +1,35 @@
+---
+title: Network Controller
+tags:
+  - Widgets
+  - Configuration
+  - Network
+  - Unifi Controller
+---
+
+If you're running a Unifi Controller instance, you might want to display statistics on your dashboard.
+It uses the [node-unifi](https://www.npmjs.com/package/node-unifi) library under the hood, which supports
+CloudKey Gen1, CloudKey Gen2, UnifiOS-based UDM-Pro controllers as well as self-hosted UniFi controllers.
+
+There are two variations of the widget:
+- **Summary of the systems**: Shows information whether your WAN is connected, Wi-Fi is active and several other information
+- **Network information**: Connected users and connected guest devices on wired or wireless networks
+
+It requires the [Unifi Controller integration](/docs/next/integrations/network) to be configured.
+
+![](./img/screenshot.png)
+
+## Adding the widget
+Please check out our documentation on [how to add a widget](/docs/getting-started/after-the-installation#embed-integration-data-using-widgets).
+
+## Configuration
+
+### Controller summary
+
+This widget does not have any additional configuration.
+
+### Network status
+
+| Configuration  | Description                    | Values                                | Default Value |
+|----------------|--------------------------------|---------------------------------------|---------------|
+| Widget Content | Select network being displayed | <ul><li>Wired</li><li>Wi-Fi</li></ul> | Wired         |