{"id":331,"date":"2023-10-30T14:39:17","date_gmt":"2023-10-30T14:39:17","guid":{"rendered":"https:\/\/bene.webtopia.ch\/?p=331"},"modified":"2023-10-30T15:03:17","modified_gmt":"2023-10-30T15:03:17","slug":"updating-and-installing-self-hosted-unifi-network-servers-linux","status":"publish","type":"post","link":"https:\/\/bene.webtopia.ch\/?p=331","title":{"rendered":"Updating and Installing Self-Hosted UniFi Network Servers (Linux)"},"content":{"rendered":"

This article provides the steps to install and update the self-hosted UniFi Network Server to the current stable release on a Debian or Ubuntu system via APT (Advanced Package Tool). If you run into issues following the process described in this article, please take a look at the scripts provided here<\/a> to install and update the UniFi Network Application.<\/p>\n

Requirements<\/h2>\n

In order to update the UniFi Network Server via APT, it is necessary to create source files or edit lines in an existing sources.list<\/strong> file with Linux text editors: vi<\/strong> or nano<\/strong>. The repo structure should be permanent, but if there are any changes, they will be pointed out in the UniFi Network software version release posts, found in the Release<\/a> section of the Community.<\/p>\n

Before upgrading the UniFi Network Server, make sure that you have backed up the UniFi Network Database. You will need to make sure that the user has sudo permissions. <\/strong>For more information about adding a user to sudo list<\/strong>, see this Debian article.<\/a><\/p>\n

UniFi Network APT Steps<\/h2>\n

See an example of what scripts the UI Community is using to install and update the UniFi Network Server on any Ubuntu or Debian-based system in this Community post<\/a>.<\/em><\/p>\n

    \n
  1. Install required packages before you begin with the following command:\n
    sudo apt-get update && sudo apt-get install ca-certificates apt-transport-https<\/pre>\n<\/li>\n
  2. Use the following command to add a new source list:\n
    echo 'deb [ arch=amd64 ] https:\/\/www.ui.com\/downloads\/unifi\/debian stable ubiquiti' | sudo \r\ntee \/etc\/apt\/sources.list.d\/100-ubnt-unifi.list<\/pre>\n<\/li>\n
  3. Add the GPG Keys.\n
      \n
    1. Method A – Recommended<\/strong>\n
        \n
      1. Install the following trusted key into \/etc\/apt\/trusted.gpg.d<\/code>\n
        sudo wget -O \/etc\/apt\/trusted.gpg.d\/unifi-repo.gpg https:\/\/dl.ui.com\/unifi\/unifi-repo.gpg<\/pre>\n<\/li>\n<\/ol>\n<\/li>\n
      2.  Method B<\/strong>\n
          \n
        1. Using apt-key:\n
          sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50<\/pre>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
        2. For a new UniFi Network Server, install MongoDB. For Ubuntu 22.04, run the commands below. If you’re updating the UniFi Network Server to version 7.5, ignore these commands and instead refer to MongoDB’s help article<\/a> to update your database to the required MongoDB version 3.6<\/strong>.\n
          wget -qO - https:\/\/www.mongodb.org\/static\/pgp\/server-3.6.asc | sudo apt-key add -\r\necho \"deb https:\/\/repo.mongodb.org\/apt\/ubuntu bionic\/mongodb-org\/3.6 multiverse\" | sudo tee \/etc\/apt\/\r\nsources.list.d\/mongodb-org-3.6.list\r\nsudo apt-get update<\/pre>\n
          This step may not be required, depending on the Linux distro you have. If your distro does not come with MongoDB, and it’s not available in their repo, then please see the MongoDB installation guide (Ubuntu<\/a> | Debian<\/a>). <\/em><\/li>\n
        3. Install and upgrade the UniFi Network application with the following command:\n
          sudo apt-get update && sudo apt-get install unifi -y<\/pre>\n<\/li>\n
        4. The UniFi Network application should now be accessible at the computer’s configured local or public IP address, by typing that IP address in a browser’s navigation bar (Chrome is recommended). If it is not launching, use the following command:
          \nsudo service unifi start<\/li>\n<\/ol>\n
          When using the commands above, it is assumed you have sudo<\/code> and wget<\/code> installed. More information about sudo<\/code> can be found here<\/a>, and wget<\/code> here<\/a>.<\/em><\/p>\n
           <\/h2>\n
          Other Helpful Commands<\/h2>\n