Ubiquiti Employee
Posts: 627
Registered: ‎06-27-2012
Kudos: 375
Solutions: 31
Contributions: 6


[ Edited ]

Added 3/25/2015


Just a few updates for frequent misconceptions/issues/helpful links & tips.  Special thanks to @Josh123 for writing these points, it is a great addition to the community!


  1. Java 7 is required in Windows. If you're having issues with mFi launching check the version and where the shortcut is pointing.  One possible solution is a standalone Java install (so it isn't auto-updated or insecure for browsers):
  2. mongoDB 2.4.x is required
  3. mongoDB gets very large for a variety of reasons - plan ahead with sufficient disk space and set storage duration as low as you're willing.
  4. 64-bit OS is *highly* recommended, otherwise your db will run out of space quickly.
  5. Most here seem to be happier with mFi on Linux (Ubuntu 14.04 being popular) or OS X
  6. Setting a static IP for devices -
  7. There is currently no cloud service provided but some have used Amazon AWS (see forum posts)
  8. FAQ including how to run as a service on Windows --  and Debian / Ubuntu install ->
  9. Custom Sensor definitions and pinouts
  10. Stories / Examples -



Original FAQ Content from UBNT-Randy:


What ports does the mFi Controller Use?
mFi Controller 1.0.8 and prior defaulted to ports 9080 and 9443.
mFi Controller 1.1.0 and later uses ports 6080 and 6443, in order to not conflict with AirControl.
If a system was upgraded, it will continue to use the ports it originally used, so that active devices will still operate. For instance, if a 1.0.7 system was using the default ports of 9080/9443, it will continue to use those ports after being upgraded to 1.1.1.
The default ports can be modified in the /data/ file.
The mFi Cloud listens to several ports (80, 6080, 9080, ...) in order to support newer and older versions of firmware.
You should always be careful to specify the mFi Controller ports in the mPort and mPower embedded web pages (example:
Why is 32bit OS not recommended?
32bit OS is not recommended because of mongo's limitation. The database size on a 32bit OS is limited to around 2GB. Enable journaling (for robustness) will further reduce database capacity. The sensor data do fill up quickly if you have lots of sensors.
Is mFi going to support 32bit OS going forward?
No. We will not support running on 32bit OS going forward. But we will not prohibit the SW from running on a 32bit OS either. Bugs on 32bit OS only will not get the priority.
Should I migrate my database to a 64bit OS system now?
How to copy the database from one system to another
It is recommended to use the in-app upgrade process. However, if that is not possible, such as if the server won't start, you can copy the database over manually. This is unsupported and not extensively tested, so use with caution.
The database is located at:

  • Unix: /var/lib/mfi/db/
  • Windows: /data/db/

    To make a copy of the existing database:
  • make sure mFi is stopped
  • copy the entire /db/ directory to a new location

    To install the database on a new system:
  • make sure mFi is stopped on the new system
  • if the new mFi system is a fresh install, set is_default=false in /data/
  • copy the database directory the new system
  • start the new system

    It is recommended to keep a copy of the old database until it is up and running on the new system. A common error is to just move the old database to the new location, and forget to set is_default=false, and have the new system overwrite the old database when it starts.