How to run a Real-Time Speed Test from your UniFi Controller

You’ve probably been there: things feel slow, video calls start freezing, and your gut tells you the internet isn’t performing the way it should. The natural instinct is to pull up Speedtest.net—but what if you could run a test directly from your UniFi Controller and get the full picture from your gateway’s perspective?

That’s exactly what this post is about. We’ll show you how to run a real-time speed test using UniFi tools and understand what those numbers actually mean for your network. No browser tests. No guessing. Just raw data straight from the gateway.

Let's dive in !!

Before we dive in, please don't self-host your UniFi Controller if you take care of client networks. Sooner or later this will cause issues! It's fine for home users, but definitely not recommended for IT service businesses and MSPs. If you want secure, reliable and a scalable hosting solution check out UniHosted.

Why test from the controller?

Running a speed test from your device tells you how fast your device is getting traffic. That’s useful—but it doesn’t account for everything. What about your network congestion? What about the gateway? What about packet loss from your ISP?

When you run a test from your UniFi Controller (specifically from a UniFi Security Gateway, Dream Machine, UDM Pro, or similar), you’re testing directly from the source of your network to the internet. This gives you the most accurate idea of what your ISP is actually delivering.

What you need

You’ll need:

  • A UniFi Console (Dream Machine, UDM-Pro, UDR, etc.)
  • UniFi OS version 3.0+ and the Network app installed
  • An active internet connection (obviously)
  • Access to your UniFi Controller—either via unifi.ui.com or local IP

Optional but helpful:

  • A UI Account to enable remote access and automatic testing

Where to find the speed test option

UniFi has built-in tools for this. Here’s how to get to it:

  1. Log into your UniFi Controller.
  2. Head to UniFi Network > Settings > Internet.
  3. You’ll see a section called Speed Test—it shows your current results.
  4. Click Run Test Now to trigger a new one.

That’s it. The controller will use the built-in gateway speed test tool to check download, upload, and latency.

What the results mean

After you run the test, you’ll see three key metrics:

  • Download Speed: How fast your gateway pulls data from the internet.
  • Upload Speed: How fast your gateway sends data out.
  • Latency (Ping): How long it takes to reach a test server and back.

Good numbers

  • Download: Should be close to your ISP plan (e.g., 200 Mbps plan should deliver at least 180 Mbps)
  • Upload: Same thing—aim for 80-90% of your subscribed speed
  • Latency: Anything under 30ms is decent for regular use

If any of these look off, it’s not necessarily a controller issue—it might be your ISP, congestion, or even just the test server at that moment.

Enable automatic tests

You can set your UniFi controller to automatically run tests and log the results. Here’s how:

  1. Go to Settings > Internet > Speed Test.
  2. Toggle Automatic Speed Test to ON.
  3. Choose your frequency (e.g., every 12 or 24 hours).

This gives you a historical log of performance, which is especially handy when you’re arguing with your ISP about flaky speeds.

Dig deeper: use the CLI

For those who like command-line tools, you can SSH into your UniFi Gateway and run the speed test manually.

  1. SSH into your device:
bash
ssh root@192.168.1.1

(Default username is usually root, and password is whatever you set.)

  1. Once logged in, run:
bash
ubnt-util speedtest

This command will give you raw speed test results from the CLI. Great for scripts or diagnostics.

Compare with device speed

Sometimes you’ll notice your laptop shows higher speeds than your gateway test—or vice versa. Here’s why that can happen:

  • Your device might be connected via Wi-Fi, which adds overhead or interference
  • Your device might hit a different test server than UniFi uses
  • The gateway speed test runs on the router's processor—it may be slightly underpowered for 1 Gbps+ testing

To get an apples-to-apples comparison, use wired connections, run tests at the same time, and try using the same server (if you can).

Speed test gotchas

  • Starlink Users: Starlink uses CGNAT, so results might vary. Also, tests could fluctuate depending on satellite handoffs.
  • High-Speed Plans (1 Gbps+): Some UniFi hardware can’t measure full gigabit speeds, especially if it's older or under load. The test may underreport your actual connection.
  • Cloudflare Warp / VPNs: If your gateway is using a VPN or tunneling, expect slower test results due to encryption overhead.

Use the data to actually fix stuff

Seeing a slow download number is just step one. Here's what you can actually do:

  • Bad speeds always: Call your ISP. Something's wrong upstream.
  • Speeds slow at peak hours: Congestion. Your ISP is oversubscribed.
  • Upload is terrible, but download is fine: That’s typical of cable internet. You might need a business or fiber plan.
  • Latency spikes: Check for overloaded gateway, background devices doing updates, or even bad cabling.

Monitor over time

The best way to catch ISP or setup issues is to run speed tests over time. That’s why enabling automatic testing is key. Every time your internet feels slow, you’ll have hard numbers to compare with.

Use the UniFi dashboard to check:

bash
UniFi > Settings > Internet > Past Results

If your 300 Mbps connection suddenly turns into 80 Mbps every night at 7 PM, you’ve got a pattern.

Speed test alternatives

UniFi’s tool is great, but here are a few other ways to test:

  • speedtest-cli: A command-line tool you can install on a Raspberry Pi or Linux box
  • LibreSpeed: Self-hosted speed test
  • Cloudflare Speed Test: Browser-based, low-latency focused: https://speed.cloudflare.com
  • Fast.com (Netflix): Good for real-world streaming performance

But none of these test directly from your gateway unless you’re SSH’d in or running it locally.

Final tips

  • Always test with wired connections for baseline
  • Don’t trust a single test—run several across the day
  • Watch out for hidden bandwidth hogs: backup tools, cloud sync, IoT cameras

Final thoughts

Real-time speed tests from your UniFi Controller are more than just a number—they’re a tool to diagnose, track, and understand your internet health. Whether you're testing once because things feel off or logging every 6 hours to build a case against your ISP, it’s all possible from your UniFi dashboard.

And hey, if you're managing multiple clients or networks and you're still self-hosting, just don’t. Things break, logs get lost, and performance suffers. That’s why we run hosted UniFi Controllers with full visibility, speed testing, and backups for every site we manage. If that sounds like a relief, give us a look at UniHosted.