UniFi - Server Hardware & Database Management


Users will gain an understanding on how UniFi Network Controller sizing and scaling affects the performance of their installs. After reading this article the user should have an understanding of general CPU and RAM sizing for the controller host machine.

Table of Contents

  1. Introduction
  2. Hosted/Virtualized Platforms for UniFi
  3. Sample Scenarios
  4. Disk Space Requirements & Database
  5. Related Articles


Back to Top

The UniFi Network Controller and protocol are lightweight enough to support server virtualization and microcomputer installations such as the UniFi Cloud Key or the UniFi Dream Machine line. While the UniFi platform scale is limitless, it’s important to note that Controller performance will depend on the Server hardware and size of the deployments under management.

Ubiquiti recommends installing UniFi on server-optimized Linux operating systems since Mac and Windows can consume server resources through unnecessary background services.

Hosted/Virtualized Platforms for UniFi

Back to Top

Hosted server virtualization platforms such as Amazon Web Services are uniquely suited to support cloud-based UniFi Network Controllers given their reliability & uptime guarantee.

Sample Scenarios

Back to Top

For comparison purposes, here are two clear real-world examples of UniFi server hardware relative to the total number devices and users they manage:

Scenario A:

  • UniFi runs on Windows XP via an older, Intel Pentium 4 PC with 1.5GB of RAM.
  • To manage 22 UAPs, with 300 simultaneous guests connected.
  • CPU usage hits 100% usage, and needless to say, the server hardware is outdated to serve the guest portal to so many guest users.
  • While Linux would help reduce CPU overhead, at the minimum, a dual-core processor is needed, with quad-core recommended to support even more guest connections.

Scenario B:

  • UniFi runs on a virtualized Linux instance via an Intel Xeon E5506, 2.13GHz Processor with 2GB of RAM,
  • To manage 6 UAPs, with 120 simultaneous guests across 3 separate sites, totaling approximately 6 Megabits per second of web traffic.
  • CPU usage sits at around 20% usage, which includes other background services, like firewall & dnsmasq.

Disk Space Requirements & Database

Back to Top

Separately from CPU & RAM needs, also consider the disk space requirements for the UniFi server. This will depend on the total number of UniFi devices and user devices under management, as well as data retention settings configured in the Controller.

Based on MongoDB, the UniFi Network Controller builds, stores, and maintains a highly scalable database of information relating to UniFi devices, users, as well as the UniFi server itself.

Under the maintenance tab of the Controller Settings, specify the historical data retention period to auto-prune the database size. When no period is specified, use the compact database feature to manually prune the database. However, before touching the database, always make sure to download a backup file of the UniFi Network Controller.

The disk space required will vary greatly from deployment to deployment, but in order to give users a baseline, we recommend starting with 25GB minimum and evaluating down the line if more is necessary.

Related Articles

Back to Top

UniFi - Network Controller: Repairing Database Issues on the UniFi Controller

Was this article helpful?
14 out of 30 found this helpful
Can't find what you're looking for?
Visit our worldwide community of Ubiquiti experts for more answers
Visit the Ubiquiti Community