Software-update: UniFi 5.10.17

UniFi logo (80 pix)Ubiquiti Networks heeft een stabiele versie vrijgegeven van UniFi, met 5.10.17 als versienummer. Dit is een netwerkmanagementcontroller waarmee een netwerkomgeving op basis van UniFi-hardware beheerd kan worden. Denk daarbij aan het inregelen van accesspoints, routers en switches om tot een optimaal dekkend, uniform netwerk te komen. Daarnaast kun je een hotspotportal opzetten en integreren met verschillende paymentproviders, zoals Authorize en PayPal. Voor gebruikerservaringen kun je zowel op Gathering of Tweakers als op het forum van Ubiquiti terecht. Een demo is op deze pagina uit te proberen. Uitgebreide release notes zijn op deze pagina te vinden, dit zijn in het kort de belangrijkste veranderingen:

UniFi Network Controller 5.10.17 Stable has been released

Introducing our latest release for UniFi Network hardware. This is the latest stable release for UniFi Network 5.10, which is our current stable release branch.

Important Notice:

We've updated the UniFi Network controller to improve security. Starting with UniFi Network version 5.10, the required minimum firmware for UAP/USW will be 4.0.9 and for USG will be 4.4.34. Devices on earlier firmware will show in the controller and work as you've configured them, this update doesn't change any of the settings. However, please note you will not be able to modify the device configuration until you update the firmware.

This update contains an upgrade to the overall security of the UniFi platform and its devices, it is highly recommend that everyone upgrades to this version. We will also be preparing 5.6.41 to accommodate 1st gen AC devices.

We want our users to have time for adoption and migration to this version, all feedback is welcome.

How to play safe?
Make sure you always do a backup before any updates, especially if you plan to upgrade your existing installation.


  • For people who are migrating from v3, there're many changes to APIs and it's not backward compatible. You may need to update the shell library (unifi_sh_api) and/or your customized portal/external portal code.
  • Windows users must have x64 Java installed to use the cloud tie in, as we only support 64 bit webRTC library. Please see HERE and download the missing version (64bit offline Windows install package). The controller will run in an x86 only environment, or with x86 Java, but the tie in will not work.
  • You cannot re-use a VLAN ID for dynamic VLAN if it is set as a static value for another SSID on the same AP. So, if I have a SSID set to use VLAN 10, I cannot use VLAN ID 10 for RADIUS controlled VLAN users as those users will not get an IP.
  • Smart Queue QoS is similar to the implementation as in EdgeOS (see HERE). It's worth noting that maximum throughput will be affected when using QoS, as traffic is not offloaded. There are some rough guidelines in the article linked above.
  • DFS channels can not be used for wireless uplink in the US. Please use non-DFS channels if you need to use wireless uplink on dual band UAPs.
  • Official UniFi MIBs can be downloaded from HERE and HERE (those are 2 different files).
  • For hotspot management console, make sure you have bookmark the URL with site ID (i.e. x66cipn3, or whatever random string is generated for that site). For example:
  • For Debian/Ubuntu users, please update your APT source (see HERE).
    • unifi-beta/unifi-rapid are obsoleted. The old repo has been removed.
    • The following affects APT versions 1.5 onward (Ubuntu 17.10 and Debian Sid or newer). A recent version of the apt-secure man page stated: "Since version 1.5 changes in the information contained in the Release file about the repository need to be confirmed before APT continues to apply updates from this repository", meaning that when performing an update from a major version to the next (for example 5.6.x to 5.7.x) the apt-get update will result in an error. To fix this run the command the following way: apt-get update --allow-releaseinfo-change
  • Cloud Access feature in this release is not supported on Linux/ARMv6 architecture (e.g. Raspberry Pi 1). If you have problem starting controller on this platform, please remove the native library:
    sudo rm /usr/lib/unifi/lib/native/Linux/armhf/
  • As of 5.7.x+ we only support Java 8. At this time Java 9+ is not supported.
  • Features like airtime fairness, bandsteering, load balancing and minimum RSSI are default disabled. If you need them you need to go to Settings>Site and check Enable advanced features.
  • If you previously used Google Maps for a site map, then you have to enable this feature again by adding an API key. This is done under Settings>Controller. There is a linked guide with instructions.
  • New Cloud Access requires outbound 8883/tcp to be open/unrestricted.
  • Linux systems must be running a version of MongoDB prior to 3.6.x. We recommend 3.4.x. This is most likely to be an issue on Ubuntu 18.04 LTS, as it currently offers MongoDB 3.6.x.
  • The proper keystore alias and name are `unifi`. If your custom SSL cert is no longer working, please verify that you are using the proper keystore and alias. A bug previously allowed `ubnt` to work, although that was never technically correct. If you find mention of these invalid steps on the community, please point them out so we can fix them.
  • The initial database migration will take longer than normal. It is expected to see mongo using most, if not all, of the available CPU cycles during this process. Please be patient, this process could easily take 15+ minutes, depending on the amount of historical stats, as well as the system specs. As always, err on the side of caution, and make a backup before upgrading.
  • The controller will not start if it is set to bind to a privileged port (<1024), as it now runs as a non-root user.
  • If your controller is running on a UniFi Cloud Key (UCK), make sure it is on firmware 0.6.4 or later, otherwise the controller will not start. This firmware is available via the normal upgrade mechanism found in the controller or it's local management page. Make sure to make a backup before upgrading the UCK firmware, as you'll need it to restore after, and it's good to have a backup on hand before any controller upgrade.
  • Support for PicoM2 and 1st gen AC models was dropped in 5.7.x. Please see our announcement HERE.
  • As of release branch 5.7.x we've made some important changes to the Wireless Uplink feature (feature details HERE).
    • We removed the "Enable automatic uplink failover" from wireless uplinks as it is no longer needed.
    • We added the ability to opt an AP in or out of wireless uplinking to another AP. This is done by checking the "Allow meshing to another access point" option found under device properties>Config>Wireless Uplink.
      • This option should be disabled on wired APs, but is required to be enabled on wireless APs.
      • If you disable this option on a downlink/wireless AP, then your AP will be disconnected from the network and require further action (including physical access).
      • If upgrading from 5.6>5.7 then this already be disabled on wired APs, but if upgrading from an earlier 5.7. release then this may be enabled on wired APs.
      • Again, this option should be enabled on downlink/wireless UAPs only. It should not be enabled on wired UAPs.
    • We added the ability to set uplink priorties. This allows you to define the preferred uplinks for a downlink/wireless AP.
  • Fixed IPs (DHCP reservations) are now required to use unique IPs. The same IP cannot be assigned to more than one device. For configurations that already contain duplicates, only the most recently active device will have its fixed IP provisioned to USG. The controller's server.log will contain a log message skip provisioning duplicate fixed IP <IP address> for user[<MAC address>] indicating which was omitted where there are conflicts.
Possible Upgrade Paths:
  • The following listed versions are the latest version you can upgrade directly from for recent release branchs: 5.10.16, 5.9.33, 5.8.30, 5.7.28, 5.6.40.
    • As long as you are on that release or an earlier release within each branch, then you can (directly) upgrade to this release. The earliest release you can directly upgrade from is 3.1.0. It's possible there may be a few exceptions to that. If your controller is version starts with 2.x or 1.x then you will need to upgrade to 3.x before you can upgrade to this release.
    • The release branch is determined by the first 2 numbers (so 5.10, 5.9, 5.8, etc). The last number determines the version (within that branch). A newer release is indicated by a higher number, and an earlier release is indicated by a lower number. All release branches start at .0 (e.g. 5.10.0, 5.9.0, etc.).
    • If you're on a newer release than what is mentioned, then you'll have to wait until this release is updated so that it supports upgrading from the release you're running now.
Known Issues:
  • airTime will not work if a radio is disabled and/or there isn't any SSID present. This will be fixed in a future release. If you enable it, and it still isn't working, then you may need to force a refresh without cache.
  • If you start both a 2.4GHz and 5GHz scan in quick succession, then it will fail.
  • It is expected that airView will stop occasionally. A stop/start sequence should restore functionality.
  • If you start an airTime scan while airView is running, then airView will stop and you'll need to perform a stop/start sequence to get it working again. This will be fixed in the future.
  • Some statistics on the dashboard are still under development. Please share any and all feedback!
  • If the web interface doesn't seem to be displayed/drawn properly, then you likely are hitting a browser caching issue. Please force a hard refresh, and that will clear up any caching issues. Thanks!
Controller bugfixes/changes since 5.10.12:
  • Fix an issue that could prevent database migration from succeeding when upgrading from a previous version.
  • Fix issue where setting SSH username and password on a UCK would fail and not notify the user.
  • Fix issue when clicking Submit button for changing SSH credentials.
  • Fix L3 adopt and upgrade process (reported HERE).
  • Fix external guest portal cookies (reported HERE).
  • Fix translations for zh_CN.

Versienummer 5.10.17
Releasestatus Final
Besturingssystemen Windows 7, Linux, macOS, Windows Vista, Windows Server 2008, Windows Server 2012, Windows 8, Windows 10, Windows Server 2016
Website Ubiquiti
Licentietype Voorwaarden (GNU/BSD/etc.)

Door Bart van Klaveren

Downloads en Best Buy Guide

14-02-2019 • 07:00

34 Linkedin

Submitter: lennardrk

Bron: Ubiquiti


16-12 UniFi 6.5.55 13
09-'21 UniFi 6.4.54 18
06-'21 UniFi 6.2.26 38
05-'21 UniFi 6.2.25 80
03-'21 UniFi 6.1.71 62
11-'19 UniFi 5.12.22 30
10-'19 UniFi 5.11.50 1
02-'19 UniFi 5.10.17 34
10-'18 UniFi 5.9.29 12
07-'18 UniFi 5.8.24 7
Meer historie

Reacties (34)

Wijzig sortering
Ik heb een Unifipi (controller draait dus op een pi) en sinds de update kan ik niet meer aan de GUI.
Connection refused.

Aangezien de controller niet vereist is voor de AP's, werkt gelukkig de wifi nog wel, maar de captive portal niet meer.
Steek je licht even op bij het forum van UBNT, daar staan een hoop problemen en oplossingen voor problemen na de update.

Zo uit het hoofd:
Java-versie up-to-date? Degene die van de repositories van Raspbian komt is niet nieuw genoeg.
Wat is de foutmelding die je krijg in server.log? Dan kunnen ze ook iets gerichter helpen.
Je zou je vraag ook nog op het Nederlandse forum kunnen stellen.
Dit had ik ook op mijn RPi, moest Java updaten naar versie 8.

Ik heb deze handleiding gevolgd.
Dat deed het 'm.
24u zonder controller is geen ramp, maar fijn is anders.
Mooie software, maar vereist nog altijd Java.
Gewoon in docker draaien, dan maakt dat niets uit:
Dat image werkt volgens mij niet op een Rpi. Daarvoor kan je deze gebruiken, word vrij vaak bijgewerkt:
Ik draai hem in Docker op m'n synology, maar weet jij een goede methode om te updaten? Een aantal keer geprobeerd, maar tot gevolg gehad dat ik alles opnieuw moest instellen. Momenteel loop ik wat achter, namelijk 5.6.19. Alvast bedankt!
Bij dit image zou opnieuw instellen niet nodig moeten zijn als je de /unifi directory van de container persistent maakt door hem op de host te plaatsen.

Ik draai hem ook op mijn Synology maar start de container via de command-line. Ik heb het 'docker run' commando in een één-regel-script gezet. Helaas ondersteunt de GUI namelijk niet alle opties die ik wil meegeven, zoals '--init' en '--rm', en op de command-line gaat dat wel. Je kunt de container nog steeds monitoren via de GUI dan.

Omdat ik '--rm' meegeef bij het opstarten wordt de container verwijderd zodra ik deze stop, dus upgraden is niks meer dan:
  • docker stop unifi
  • docker pull jacobalberty/unifi:stable

[Reactie gewijzigd door Yggdrasil op 14 februari 2019 09:41]

Hier een duidelijke uitleg hoe je dat kan maken.
Docker containers zijn wegwerp objecten, tenzij je de /unifi map geredirect hebt word inderdaad met elke update je configuratie verwijderd

Ik heb momenteel geen docker machines bij de hand maar uit mijn hoofd is het de Config parameter wat meegegeven moet worden (op staat hier vast uitleg over hoe dit te doen)
Deze week geupgradet naar de laaste versie, kwam ook van 5.6.X.
Na een beetje mieren en puzzelen kwam ik op dit ([Ubiquiti & IPTV] Ervaringen & Discussie) topic.

Heeft me enorm geholpen, alles werkt nu.
Docker is ook niet zaligmakend, paar maanden geleden moest je Unifi nog een tijd op een niet productie build van Docker draaien omdat er weer iets stuk was. Voor grote installaties echt een no go.
Onzin, ik draai deze nu ongeveer een jaar op de gewone docker release, werkt perfect.

[Reactie gewijzigd door kiang op 14 februari 2019 09:45]

Gebruik deze nu een 1,5 jaar en hij werkt echt probleemloos, zeer gelukkig met mijn Ubiquite systeem (met 2 AP's).
gebruik dan linux of hun cloud key als dat je stoort.

Persoonlijk heb ik het lopen op een afgeschermde vm die op een apart vlan zit waar voor de rest niets aan kan. (managment vlan)

Gelukkig hebben ze terug een donker kleuren schema toegevoegd.
Dat wit dashboard van de vorige versie wat amper leesbaar en deed pijn na een tijd

[Reactie gewijzigd door Xeon_1 op 14 februari 2019 07:12]

Ook onder Linux vereist het Java. Wordt wel meegeleverd geloof ik maar alsnog kost het veel RAM en brengt het de nodige vulnerabilities met zich mee.

Ik weet niet hoe het met deze versie zit, maar het was altijd lastig om hem onder een geisoleerd user account te draaien. Als je de installer draaide, werd het als root uitgevoerd...
Bij mij draait alles onder de user unifi... en de database onder mongodb.

Heb de instance bij AWS draaien en geinstalleerd conform de instructies van ubnt op hun website.
Dus dat lijkt nu aagepast.
Ze draaien al even niet meer als root standaard (sinds 5.6 if I'm correct), maar als de unifi user. Heb ik niets speciaals voor hoeven doen op mijn redelijk recente Debian installatie iig. De launcher draait nog wel als root overigens.

[Reactie gewijzigd door BobV op 14 februari 2019 08:21]

Veel RAM? Serieus?? Staat hier al jaren te draaien in een Ubuntu VM met 2GB ram. We hebben 21 WAP's en 11 switches. De Cloud key heeft ook maar 1GB RAM.
Op mijn raspberry pi verbruikt dit 60-70MB RAM. Dit heb ik er wel voorover.
Voor € 80 heb je een CloudKey die alles draait, automatisch update, via Unifi Cloud bereikbaar is.
Geen geld voor zoveel gebruiksgemak.
Ik gebruik voor elke WiFi site die ik maak 1-tje. Plug je in de PoE switch en instellen maar.
Zo goed als geen omkijken naar.
Totdat de stroom een keer uitvalt en je vergeet dat je die controller hebt. Been there done that en zit inmiddels in de cloud met mijn controller ;).

[Reactie gewijzigd door Typhone op 14 februari 2019 11:19]

Die controller start gewoon weer op na een power failure. Dus wat is dan je probleem?
Vaak genoeg gaat de MongoDB van de cloudkey eraan en ben je terug bij af.
Dat is mede de reden van de vernieuwde varianten die recentelijk zijn uitgebracht. Dat is een klap beter geworden inmiddels.
Hang je hem toch, net zoals al je belangrijke apparatuur, achter een UPS?
Achter een UPS hangen is één maar zorgen dat hij zichzelf uitzet en een commando krijgt is een stuk geavanceerder. Het is/was niet zozeer de cloudkey die bij mij hangt maar wel klanten. Als gevolg daarvan en de relatief grote impact van een UPS werk ik niet meer met cloudkeys.
Klopt, maar dusdanig lange stroomuitvallen zijn (bij mij) zeldzaam, dat iemand (ahum) er een keer een aardlek uit laat knallen komt des te vaker voor.
Daarom is er nu de Cloudkey2 die dit probleem niet meer heeft. Deze bevat een kleine accu.
Koop de cloudkey voor een paar tientjes
@revolised Gewoon met docker compose doen, werkt perfect! Cronjob maken dat hij het iedere x dagen uitvoerd en je hebt hem altijd up-to-date :)

Wel natuurlijk zorgen dat alle informatie op een vast volume komt te staan.
Voor wie een volledige VM appliance met Ubuntu en Unifi Controller will downloaden, klik hier. Downloaden, importeren in VMware of Hyper-V en IP address ingeven en klaar.

Klein menuutje om handmatig, update scripts, Ubuntu and Unify te updaten. Het draait hier al een jaar en nog nooit een probleem gehad.

Kies score Let op: Beoordeel reacties objectief. De kwaliteit van de argumentatie is leidend voor de beoordeling van een reactie, niet of een mening overeenkomt met die van jou.

Een uitgebreider overzicht van de werking van het moderatiesysteem vind je in de Moderatie FAQ

Rapporteer misbruik van moderaties in Frontpagemoderatie.

Op dit item kan niet meer gereageerd worden.

Nintendo Switch (OLED model) Apple iPhone SE (2022) LG G1 Google Pixel 6 Call of Duty: Vanguard Samsung Galaxy S22 Garmin fēnix 7 Nintendo Switch Lite

Tweakers vormt samen met Hardware Info, AutoTrack,, Nationale Vacaturebank, Intermediair en Independer DPG Online Services B.V.
Alle rechten voorbehouden © 1998 - 2022 Hosting door True

Tweakers maakt gebruik van cookies

Tweakers plaatst functionele en analytische cookies voor het functioneren van de website en het verbeteren van de website-ervaring. Deze cookies zijn noodzakelijk. Om op Tweakers relevantere advertenties te tonen en om ingesloten content van derden te tonen (bijvoorbeeld video's), vragen we je toestemming. Via ingesloten content kunnen derde partijen diensten leveren en verbeteren, bezoekersstatistieken bijhouden, gepersonaliseerde content tonen, gerichte advertenties tonen en gebruikersprofielen opbouwen. Hiervoor worden apparaatgegevens, IP-adres, geolocatie en surfgedrag vastgelegd.

Meer informatie vind je in ons cookiebeleid.


Toestemming beheren

Hieronder kun je per doeleinde of partij toestemming geven of intrekken. Meer informatie vind je in ons cookiebeleid.

Functioneel en analytisch

Deze cookies zijn noodzakelijk voor het functioneren van de website en het verbeteren van de website-ervaring. Klik op het informatie-icoon voor meer informatie. Meer details


    Relevantere advertenties

    Dit beperkt het aantal keer dat dezelfde advertentie getoond wordt (frequency capping) en maakt het mogelijk om binnen Tweakers contextuele advertenties te tonen op basis van pagina's die je hebt bezocht. Meer details

    Tweakers genereert een willekeurige unieke code als identifier. Deze data wordt niet gedeeld met adverteerders of andere derde partijen en je kunt niet buiten Tweakers gevolgd worden. Indien je bent ingelogd, wordt deze identifier gekoppeld aan je account. Indien je niet bent ingelogd, wordt deze identifier gekoppeld aan je sessie die maximaal 4 maanden actief blijft. Je kunt deze toestemming te allen tijde intrekken.

    Ingesloten content van derden

    Deze cookies kunnen door derde partijen geplaatst worden via ingesloten content. Klik op het informatie-icoon voor meer informatie over de verwerkingsdoeleinden. Meer details