Update August 2019
I have added some new updates to the GitHub repo that will add the official Ubiquiti repo and update you to the latest Unifi software.
To install this update and get to the latest version of Unifi, you need to go to the console and run menu option 3 in the menu.
Update – v3.1
I have updated the appliance to Ubuntu 18.04 as well as the latest version of Unifi as of Feb 2019. The new download links are below. Enjoy!
Out with the old
My Ubiquiti Unifi 2.0 virtual appliance has gotten quite a few downloads. So I decided to revamp it for 2018. This version is easier to use, comes with the latest UniFi server (as of this post), and can be more easily updated in the future.
I also created a post on how to build your own UniFi server in AWS using a few simple steps too, but for those purists who still need a solution that can run on-prem in VMware or Hyper-V… Long live the OVA Virtual Appliance!
In with the new
So what makes my new “Version 3.0” virtual appliance more kick ass? Simplicity.
This new version comes with a console based menu that allows you to update and configure the appliance.
So what does the menu help with?
- Shows current IP address
- Allows you to easily update Unifi via the official APT repository
- Allows you to configure the network interface (DHCP or Static) without knowing anything about Linux
- Updates my unifi-va scripts directory from my GitHub Repo (http://github.com/recklessop/unifi-va)
- Change the “unifi” user’s password
Basically, all the things that non-Linux people wouldn’t like about running UniFi on a Linux machine can be done via this menu. As I think of more things to add I will update my GitHub repo and you can update your appliance by running option 3 in the menu.
Deploying v3
Deploying v3 is just like deploying any other virtual appliance.
First, download the virtual appliance (select the appropriate version).
VMware 6.0 and older SHA1 Version
Then import it into your hypervisor. For VMware 6.0 and older go to File, then “Deploy OVF Template”. For VMware 6.0 and newer, with the web interface, right click on your cluster or host and select “Deploy OVF Template”.
Configuring v3
Configuration is already mostly done, all you need to do is make sure the virtual appliance has an IP address. Once it does go to a browser and type in https://<IP ADDRESS>:8443 and you should see the invalid SSL warning page. Click through it, and you will then see the UniFi Configuration page. From there you can either import an old configuration or create a brand new appliance.
Get Update Notifications
If you want to be kept up to date on my UniFi Virtual Appliance news, fill out the form below to get email updates when it’s time to run the “Unifi-VA Scripts Update” from the menu on your appliance
Feedback
I’m always looking for feedback. So if you come across something that I could do better in the virtual appliance let me know. You can use the Drift chat box in the bottom right corner, or shoot me a message on Twitter (@recklessop), or shoot me an email ([email protected]).
Thanks for reading!
Looking for the UniFi Hardware?
If you haven’t completed your Ubiquiti Unifi hardware deployment, Amazon has great prices on all the UniFi hardware.
| UniFi Security Gateway | Unifi PoE Switch | Unifi Wireless Access Point |
sure so long as it meets the ubuntu requirements
Hi Justin,
Just installed this on my ESXI and is working fine.
Right after i went in the web-ui i got notified that there is an update for Unifi software 5.10.21. So i tried updating with the console menu but it doesn’t seem to update. Do i need to download the .deb file and place it somewhere?
Justin,
Just wanted to thank you for putting this together. You are a life saver.
SHA256 version Worked great on a 6.0 host managed by 6.7 vcenter (Latest patch on both as of 4/20/2019)
It blows my mind that the vendor is incapable of putting something like this together. I am so thankful that I don’t have to run this in windows and start the application in order to get management functionality.
Best,
Mike D
Wanted to throw out there that the version 2 appliance disks filled up, maybe I was saving too many backups?
There was also alot of superseded kernel images in there
Anything we need to worry about w\version 3.1?
Hi, there seems to be a problem with updateing the VA from the console, do you know if it is a common problem with the VA?
yes i installed the appliance software from a tar file not from an apt repo. I need to fix the image.
to update to the newest controller version which is 5.10.21 use these commands under bash shell on the console
if a new version comes out just change the numbers in the URL
wget https://dl.ubnt.com/unifi/5.10.21/unifi_sysvinit_all.deb
sudo dpkg -i unifi_sysvinit_all.deb
To update go to option 4 Bash shell
type the following to get current release. change numbers if a new version comes out
wget https://dl.ubnt.com/unifi/5.10.21/unifi_sysvinit_all.deb
Sudo dpkg -i unifi_sysvinit_all.deb
Hi! I would like to install some other features (like an dhcp server, ip tables) in the same server… What is the SU password of this image??
if i typ the:
wget https://dl.ubnt.com/unifi/5.10.25/unifi_sysvinit_all.deb
Sudo dpkg -i unifi_sysvinit_all.deb
the controller stays on 5.10.23. It updates from 5.10.23 to 5.10.23
where is the fault? 🙂
did wget write to another file “unifi_sysvinit_all.deb.1” or something, because the file existed from the 5.10.23 download?
in this case you would need to rename the file or use the correct one in “sudo dpkg …”
If you want to update the UniFi Software via Menu Option 1, you need to add their official repository. Run these commands from shell:
echo ‘deb http://www.ui.com/downloads/unifi/debian stable ubiquiti’ | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg
After that it should work.
I have actually updatedt he scripts on github to add the repo and update. Posting a note on how to do it soon.
Yes, it works. It doesn’t make much sense to update the Unifi Software via Menu Option 3 though, because of it’s naming “Update Unifi-va Scripts”, while menu option 1 “Update Unifi Application” does not update the Unifi Application.
Absolute hero
The two different options do different things.
the update Unifi-VA scripts updates my scripts from the github repo. the Update Unifi Appliance runs apt update; apt upgrade
Thanks a lot for this, worked like a treat.
Hi Justin. Big fan of your appliance. I work for a small MSP and we utilize your appliance for clients that already have a virtualized environment. Unfortunately for some reason when you add multiple to unifi cloud access, only one shows up. Is there a unique identifier that I could change in the appliance that would allow multiple sites to show up under the unifi cloud controller?
Thanks!
Thanks Bjoern, that worked! It would be nice to show the current unifi controller version in the CLI menu, would that be possible?