Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.



Most of these commands must be run as root, so either log in as root or use sudo.


Any commands starting with nano can be substituted with vi if nano is not installed.

  1. Stop the UniFi SDN controller

    Code Block
    systemctl stop unifi

  2. Back up your current installation. Choose one of the following options.

    1. Take a snapshot of the entire VM (easiest to restore)
    2. Save a copy of the latest auto backup file from the autobackup directory

      Code Block

    3. Copy the entire data directory to another location or make an archive of it

      Code Block

  3. Change directory to the temporary directory

    Code Block
    cd /tmp

  4. Install the generic Linux version of the UniFi SDN controller


    Make sure to read the release notes and ensure that your server meets the requirements, including Java and MongoDB versions!

    1. Find the latest version number from the UniFi download page
    2. Download the ZIP file

      Code Block


      Fill in [version] with the correct version number. ex. /unifi/5.11.50/

    3. Unzip the contents

      Code Block
      unzip -q -d /opt

    4. You should be prompted to replace files

      Code Block
      replace /opt/UniFi/bin/mongod? [y]es, [n]o, [A]ll, [N]one, [r]ename:

    5. Enter A and press enter.

    6. Set the correct owner for the new files

      Code Block
      chown -R ubnt:ubnt /opt/UniFi

    7. Start the service

      Code Block
      systemctl start unifi

  5. Go to your controller's web address in a browser.
    1. The address will be the FQDN or IP followed by the admin port, 8443.

      Code Block

    2. It is safe to bypass certificate warnings since the controller does not have publicly trusted certificates installed.
  6. That's it! Everything should be updated and working!