Differences

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

--- networking:wireless:unifi [2022/01/13 10:34]
jcooper
+++ 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 =====
-https://help.ubnt.com/hc/en-us/articles/220066768-UniFi-How-to-Install-Update-via-APT-on-Debian-or-Ubuntu
+:!: Unifi Controller seems to be easy to install, run and update under **Docker**.  See below.
-http://www.youtube.com/watch?v=NSMM5dT1vSk
+https://pimylifeup.com/ubuntu-unifi-controller/
+:!: 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
+# 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>
 ==== Firewall ====
@@ Line 37: / 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 96: / Line 140: @@
 ===== Guest Networks =====
-**Guest FAQ**: http://wiki.ubnt.com/UniFi_FAQ#Guest_Access
+Simple guest access uses single DHCP server and restricts access to Internet only.
-**Guest Doc**: https://help.ubnt.com/hc/en-us/articles/115000166827-UniFi-Wireless-Guest-Network-Setup
+<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>
-**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.
   * To **restrict bandwidth of guests**, create a "Guests" User Group
@@ Line 119: / 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 273: / Line 305: @@
 If wireless clients connect but do not have network access for example NLA shows unidentified:
-  - Disable the uplink connectivity monitor. (Disable this if not using wireless uplink) System -> Uplink Connectivity Monitor
+  - Disable the uplink connectivity monitor. (Disable this if not using wireless uplink) **System -> Uplink Connectivity Monitor**
-  - Enable the Multicast Enhancement. WIFI -> SSID -> Advanced
+  - Enable the Multicast Enhancement. **WIFI -> SSID -> Advanced**
-  - Enable Fast Roaming. WIFI -> SSID -> Advanced -> Enable Fast Roaming
+  - 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