Skip to content

Commit

Permalink
Unifi-Network-Application: Refactor docs
Browse files Browse the repository at this point in the history
  • Loading branch information
owine committed Nov 26, 2023
1 parent 0126583 commit 915eaa8
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 12 deletions.
Original file line number Diff line number Diff line change
@@ -1,28 +1,31 @@
# Unifi Controller
# Unifi Network Application

## What is it?

[Unifi Controller](https://www.ui.com/download/unifi/) software is a powerful, enterprise wireless software engine ideal for high-density client deployments requiring low latency and high uptime performance.
[Unifi Network Application](https://www.ui.com/download/unifi/) software is a powerful, enterprise wireless software engine ideal for high-density client deployments requiring low latency and high uptime performance.

| Details | | | |
|-------------|-------------|-------------|-------------|
| [:material-home: Project home](https://www.ui.com/download/unifi/){: .header-icons } | [:octicons-link-16: Docs](https://github.com/linuxserver/docker-unifi-controller/blob/master/README.md){: .header-icons } | [:octicons-mark-github-16: Github](https://github.com/linuxserver/docker-unifi-controller){: .header-icons } | [:material-docker: Docker](https://hub.docker.com/r/linuxserver/unifi-controller){: .header-icons }|
| [:material-home: Project home](https://www.ui.com/download/unifi/){: .header-icons } | [:octicons-link-16: Docs](https://github.com/linuxserver/docker-unifi-network-application/blob/main/README.md){: .header-icons } | [:octicons-mark-github-16: Github](https://github.com/linuxserver/docker-unifi-network-application){: .header-icons } | [:material-docker: Docker](https://hub.docker.com/r/linuxserver/unifi-network-application){: .header-icons }|

!!! Warning
This role is a replacement for the previous Unifi Controller role. This is not an in-place replacement. In order to migrate, you must perform a full backup from the Unifi web interface, and restore from that backup when running the setup wizard in a fresh instance of the Unifi Network Application.

### 1. Installation

``` shell

sb install sandbox-unifi
sb install sandbox-unifi-network-application

```

### 2. URL

- To access Unifi Controller, visit `https://unifi._yourdomain.com_`
- To access Unifi Network Application, visit `https://unifi._yourdomain.com_`

### 3. Setup

1. Visit the Unifi Controller site at `https://unifi._yourdomain.com_`
1. Visit the Unifi Network Application site at `https://unifi._yourdomain.com_`

2. For Unifi to adopt other devices, e.g. an Access Point, it is required to change the inform IP address. Because Unifi runs inside Docker by default it uses an IP address not accessible by other devices. To change this go to Settings > System Settings > Controller Configuration and set the Controller Hostname/IP to a hostname or IP address accessible by your devices. Additionally the checkbox "Override inform host with controller hostname/IP" has to be checked, so that devices can connect to the controller during adoption (devices use the inform-endpoint during adoption).

Expand All @@ -37,11 +40,11 @@ sb install sandbox-unifi

When using a Security Gateway (router) it could be that network connected devices are unable to obtain an ip address. This can be fixed by setting "DHCP Gateway IP", under Settings > Networks > network_name, to a correct (and accessible) ip address.

- [:octicons-link-16: Documentation](https://github.com/linuxserver/docker-unifi-controller/blob/master/README.md){: .header-icons }
- [:octicons-link-16: Documentation](https://github.com/linuxserver/docker-unifi-network-application/blob/master/README.md){: .header-icons }

!!! Note
📢 The default setup only publish the 8080 tcp port, which is the bare minimum to allow communication between your network equipment and Unifi Controller.
Depending on your requirements, you may need additional ports according to the [:octicons-link-16: Documentation](https://github.com/linuxserver/docker-unifi-controller#parameters) .
📢 The default setup only publish the 8080 tcp port, which is the bare minimum to allow communication between your network equipment and Unifi Network Application.
Depending on your requirements, you may need additional ports according to the [:octicons-link-16: Documentation](https://github.com/linuxserver/docker-unifi-network-application#parameters) .

The recommended way to customize these parameters is to use the [inventory](../../saltbox/inventory/index.md).

Expand All @@ -50,7 +53,7 @@ sb install sandbox-unifi
```
### Open Specified Ports for the specified container ###
##### Unifi Ports for aditional services #####
unifi_docker_ports_custom:
unifi_network_application_docker_ports_custom:
- "1900:1900/udp" #Required for Make controller discoverable on L2 network option
- "8843:8843/tcp" #Unifi guest portal HTTPS redirect port
- "8880:8880/tcp" #Unifi guest portal HTTP redirect port
Expand Down
2 changes: 1 addition & 1 deletion docs/sandbox/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@
- **[transmissionx](../sandbox/apps/transmissionx.md)** - tag - `sandbox-transmissionx`
- **[trilium](../sandbox/apps/trilium.md)** - tag - `sandbox-trilium`
- **[tubearchivist](../sandbox/apps/tubearchivist.md)** - tag - `sandbox-tubearchivist`
- **[unifi](../sandbox/apps/unifi.md)** - tag - `sandbox-unifi`
- **[unifi-network-application](../sandbox/apps/unifi-network-application.md)** - tag - `sandbox-unifi-network-application`
- **[unmanic](../sandbox/apps/unmanic.md)** - tag - `sandbox-unmanic`
- **[uptime-kuma](../sandbox/apps/uptime-kuma.md)** - tag - `sandbox-uptime-kuma`
- **[varken](../sandbox/apps/varken.md)** - tag - `sandbox-varken`
Expand Down
2 changes: 1 addition & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -305,7 +305,7 @@ nav:
- Networking:
- Kcptun-client: sandbox/apps/kcptun-client.md
- Kcptun-server: sandbox/apps/kcptun-server.md
- Unifi: sandbox/apps/unifi.md
- Unifi Network Application: sandbox/apps/unifi-network-application.md
- Wireguard: sandbox/apps/wireguard.md
- MakeMKV: sandbox/apps/makemkv.md
- Puddletag: sandbox/apps/puddletag.md
Expand Down

0 comments on commit 915eaa8

Please sign in to comment.