Skip to content

"Minor editing of unifi_os.md" #3232

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sspencerwire merged 1 commit into from
Mar 26, 2026
+20 −19
Merged

"Minor editing of unifi_os.md" #3232

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 20 additions & 19 deletions docs/guides/network/unifi_os.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,37 +1,38 @@
---
title: Ubiquiti UniFi OS Controller
title: Ubiquiti UniFi OS controller
author: Neel Chauhan
contributors:
contributors: Steven Spencer
tested_with: 10.1
tags:
- network
- network management
- Ubiquiti
---

# 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.
Ubiquiti's UniFi line of wireless access points and other networking equipment is popular in small business and home lab environments. This includes the author's home lab.

The UniFi OS Server is the next generation UniFi controller software designed aroud Podman.
Designed around Podman, the UniFi OS Server is the next generation UniFi controller software.

While technically designed for Debian and Ubuntu, Ubiquiti's UniFi OS Server can also be installed on Rocky Linux.
While technically designed for Debian and Ubuntu, you can also install Ubiquiti's UniFi OS Server 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
- The ability to elevate (`sudo`) permissions for some commands

## Installing Prerequisites
## Installing prerequisites

First install the prerequisite packages:
Install the prerequisite packages:

```bash
dnf install -y podman slirp4netns
sudo dnf install -y podman slirp4netns
```

## Downloading UniFi OS Server
## 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.

Expand All @@ -47,29 +48,29 @@ The author's file is `1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.
chmod a+x 1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64
```

## Installing UniFi OS Server
## Installing UniFi OS server

Run the downloaded file;
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`:
You will receive a prompt to install. Select `y`:

```bash
```text
You are about to install UOS Server version 5.0.6. Proceed? (y/N): y
```

After UniFi OS is installed, disable `firewalld`:
After the installation completes, disable `firewalld`:

```bash
systemctl disable --now firewalld
sudo systemctl disable --now firewalld
```

You will get a line that says:

```bash
```text
UOS Server is running at: https://IP:11443/
```

Expand All @@ -79,4 +80,4 @@ 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.
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 do not want a UniFi gateway. For instance, the author uses a MikroTik core router and switch alongside UniFi access points for better Wi-Fi coverage.
Loading