Blog

How to install UniFi Controller on Raspberry Pi

Learn how to install the UniFi Controller on Raspberry Pi OS

To install the UniFi Controller on Raspberry Pi OS, follow the steps below.

If you want fast and reliable UniFi hosting, check out HostiFi with fast support, regular backups, managed updates and prices from just $9 per month.

To learn more about our hosting plans, create an account and get started today.

You can run UniFi on pretty much anything, Windows, Ubuntu, macOS and Debian plus much more. If you want to host the UniFi Controller and not benefit from the simple setup HostiFi offers, you can host UniFi on a Raspberry Pi.

Requirements

  • A Raspberry Pi (preferably a Pi 3, 4, or newer)
  • Raspberry Pi OS (64-bit recommended)
  • SSH access or direct access with a keyboard and monitor
  • Update the system

    sudo apt update && sudo apt upgrade -

    Install Java (OpenJDK 8)

    sudo apt install openjdk-8-jre-headless -y

    Verify the installation:

    java -version
    

    You should see output similar to:

    openjdk version "1.8.0_xxx"
    

    Add UniFi Repository

    Install required dependencies:

    sudo apt install gnupg curl -y
    

    Add the Ubiquiti GPG Key:

    curl -fsSL https://dl.ui.com/unifi/unifi-repo.gpg | sudo tee /usr/share/keyrings/unifi-repo.gpg > /dev/null
    

    Add the UniFi repository to sources list:

    echo 'deb [signed-by=/usr/share/keyrings/unifi-repo.gpg] https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/unifi.list
    

    Install UniFi Controller

    Update package list again:

    sudo apt update
    

    Install the UniFi Controller:

    sudo apt install unifi -y

    Start and Enable UniFi Service

    After installation, enable and start the UniFi service:

    sudo systemctl enable --now unifi
    

    Check if the service is running:

    sudo systemctl status unifi
    

    Access the UniFi Web Interface

    Once the UniFi Controller is running, open your web browser and go to:

    https://<your-raspberry-pi-IP>:8443
    

    That's it! You should now have the UniFi Controller installed and running on your Raspberry Pi!

    HostiFi

    HostiFi provides hosting for both Ubiquiti and TP-Link software-defined-networking (SDN) applications, with servers for UniFi, UISP and Omada. We also offer network consulting, with HostiFi Pro.

    More Blog Posts

    Get the Ubiquiti Top 20

    Each month our team sifts through Ubiquiti news and content from around the web and delivers 20 of our favorite links to your inbox.

    View recent issues

    No spam. Unsubscribe anytime.

    🤩

    Discovered 3+ things that I did not know and will have a material impact on my business.

    Newsletter Subscriber

    🤩

    All the info I want/need in a single clean thread! Perfect!

    Newsletter Subscriber

    🤩

    Providing super valuable information to keep the community in the know. Awesome links page, Thank You.

    Newsletter Subscriber