New guide: Ubiquiti UniFi OS Controller

docs/guides/network/unifi_os.md

@@ -0,0 +1,82 @@
+---
+title: Ubiquiti UniFi OS Controller
+author: Neel Chauhan
+contributors:
+tested_with: 10.1
+tags:
+  - network
+---
+
+# Ubiquiti UniFi OS Controller
+
+## Introduction
+
+Ubiquiti's UniFi line of wireless access points and other networking equipment is popular in small business and homelab environments. This includes the author's homelab.
+
+The UniFi OS Server is the next generation UniFi controller software designed aroud Podman.
+
+While technically designed for Debian and Ubuntu, Ubiquiti's UniFi OS Server can also be installed on Rocky Linux.
+
+## Prerequisites
+
+- A server or virtual machine with at least 15GB free disk space
+- At least one Ubiquiti UniFi device on your LAN
+- Knowledge of network administration
+
+## Installing Prerequisites
+
+First install the prerequisite packages:
+
+```bash
+dnf install -y podman slirp4netns
+```
+
+## Downloading UniFi OS Server
+
+Go to the [Ubiquiti downloads page](https://ui.com/download) and copy the link to the UniFi OS for the CPU architecture you want.
+
+Download the file:
+
+```bash
+wget UNIFI_OS_SERVER_DOWNLOAD_LINK
+```
+
+The author's file is `1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64`. Make it executable:
+
+```bash
+chmod a+x 1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64
+```
+
+## Installing UniFi OS Server
+
+Run the downloaded file;
+
+```bash
+./1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64
+```
+
+You'll be prompted to install. Select `y`:
+
+```bash
+You are about to install UOS Server version 5.0.6. Proceed? (y/N): y
+```
+
+After UniFi OS is installed, disable `firewalld`:
+
+```bash
+systemctl disable --now firewalld
+```
+
+You will get a line that says:
+
+```bash
+UOS Server is running at: https://IP:11443/
+```
+
+Enter that in a browser.
+
+From there, it should be self-explanatory.
+
+## Conclusion
+
+Unlike Ubiquiti's previous UniFi Network controller, UniFi OS adds the ability to run on Rocky Linux versus requiring Debian-based distributions. This makes it accessible to environments which standardized on Enterprise Linux and don't want a UniFi gateway. For instance, the author uses a MikroTik core router and switch alongside UniFi access points for better Wi-Fi coverage.