Differences

This shows you the differences between two versions of the page.

--- networking:wireless:unifi [2023/01/31 13:10]
gcooper
+++ networking:wireless:unifi [2024/02/05 10:44] (current)
gcooper
@@ Line 1: / Line 1: @@
 ====== Ubiquiti Unifi ======
+**Optimize Your Network**: https://help.ui.com/hc/en-us/articles/360012947634-UniFi-Network-Optimizing-Wireless-Speeds
 **User Guide**: http://dl.ubnt.com/guides/UniFi/UniFi_Controller_V4_UG.pdf
@@ Line 26: / Line 28: @@
     * Version 3.0+
   * Integrated billing system available
+<note tip>Consider using a Docker-based configuration.</note>
+====== Server Prep ======
+[[internet:mail:zimbra:zimbra_ose#server_preparation|Server Prep]]
 ===== Controller Installation =====
+:!: Unifi Controller seems to be easy to install, run and update under **Docker**.  See below.
 https://pimylifeup.com/ubuntu-unifi-controller/
-:!: This is for a minimal Ubuntu 22.04 LTS Server with 2 vCPU, 2GB RAM and a 20GGB vHD.
+:!: This is for a minimal **Ubuntu 22.04** LTS Server with **2 vCPU**, **2GB RAM** and a **20GB vHD**.
 <file>
 apt install curl haveged gpg openjdk-8-jre-headless
-curl https://dl.ui.com/unifi/unifi-repo.gpg | sudo tee /usr/share/keyrings/ubiquiti-archive-keyring.gpg >/dev/null
+# This library is not in the default repos
+wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.0g-2ubuntu4_amd64.deb
+dpkg -i ./libssl1.1_1.1.0g-2ubuntu4_amd64.deb
+rm -f libssl1.1_1.1.0g-2ubuntu4_amd64.deb
+curl https://dl.ui.com/unifi/unifi-repo.gpg | sudo tee /usr/share/keyrings/ubiquiti-archive-keyring.gpg > /dev/null
 echo 'deb [signed-by=/usr/share/keyrings/ubiquiti-archive-keyring.gpg] https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list > /dev/null
+curl https://pgp.mongodb.com/server-3.6.asc | gpg --dearmor | tee /usr/share/keyrings/mongodb-org-server-3.6-archive-keyring.gpg > /dev/null
+echo 'deb [signed-by=/usr/share/keyrings/mongodb-org-server-3.6-archive-keyring.gpg] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/3.6 multiverse' | tee /etc/apt/sources.list.d/mongodb-org-3.6.list > /dev/null
+apt update && apt install -y mongodb-org-server && systemctl enable mongod && systemctl start mongod
+apt install unifi -y
 </file>
@@ Line 44: / Line 68: @@
 ^TCP Ports| 22, 8080, 8443, 8880, 8843 |
 ^UDP Ports| 3478                       |
+<file>
+ufw allow 22/tcp
+ufw allow 8080/tcp
+ufw allow 8443/tcp
+ufw allow 8880/tcp
+ufw allow 8843/tcp
+ufw allow 3478/udp
+ufw --force enable
+ufw status numbered
+</file>
 ==== Management ====
@@ Line 102: / Line 139: @@
 ===== Guest Networks =====
-**Guest FAQ**: http://wiki.ubnt.com/UniFi_FAQ#Guest_Access
-**Guest Doc**: https://help.ubnt.com/hc/en-us/articles/115000166827-UniFi-Wireless-Guest-Network-Setup
-**If Using VLANs**: https://help.ubnt.com/hc/en-us/articles/219654087-UniFi-Using-VLANs-with-UniFi-Wireless-Routing-Switching-Hardware
 Simple guest access uses single DHCP server and restricts access to Internet only.
+<note tip>These steps are no longer correct for Controller V8. Guest networks are now created by selecting ''Manual'' configuration and enabling ''Hotstop Portal''.  You configure the user experience by managing the Hotspot Portal.</note>
   * To **restrict bandwidth of guests**, create a "Guests" User Group
@@ Line 126: / Line 159: @@
 :!: Click in ''Security Key'' field to expose the current password.
-:!: To **restrict guest access**, make sure your guest/access control has the following **Post-Authorization Restrictions**:
-<file>
-.168.0.0/16
-.16.0.0/12
-.0.0.0/8
-</file>
 ===== Site Administrators =====
@@ Line 283: / Line 308: @@
   - Enable the Multicast Enhancement. **WIFI -> SSID -> Advanced**
   - Enable Fast Roaming. **WIFI -> SSID -> Advanced -> Enable Fast Roaming**
+===== Docker =====
+<note warning>This example uses an unsupported Docker image.  You probably want to use "linuxserver/unifi-network-application:latest" now.</note>
+Unifi Controller seems to be easy to install, run and update under Docker.
+==== docker-compose.yml ====
+=== Simple Version ===
+<file>
+version: "2.1"
+services:
+  unifi-controller:
+    image: lscr.io/linuxserver/unifi-controller:latest
+    container_name: unifi-controller
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Arizona/Phoenix
+      - MEM_LIMIT=1024 #optional
+      - MEM_STARTUP=1024 #optional
+    volumes:
+      - /root/docker/unifi/config:/config
+    networks:
+      - unifi-net
+    ports:
+      - 8443:8443
+      - 3478:3478/udp
+      - 10001:10001/udp
+      - 8080:8080
+#      - 1900:1900/udp #optional
+#      - 8843:8843 #optional
+#      - 8880:8880 #optional
+#      - 6789:6789 #optional
+#      - 5514:5514/udp #optional
+    healthcheck:
+      test: curl --fail -k https://localhost:8443/ || exit 1
+      interval: 5m
+      timeout: 15s
+    restart: unless-stopped
+networks:
+  unifi-net:
+    name: unifi-net
+</file>

Virtual Architects Support Wiki

User Tools

Site Tools

Differences

Page Tools