Ubiquiti Unifi Network add on & integration

Third party integrations
1

I’ve been trying to add the Unifi integration for about 1 week and about to give up. Just trying to see if I’m doing something incorrectly, because I can’t get it to work.

I installed the Unifi “Add-on” through “Add-ons” . I went through that setup process and then I downloaded the “Integration” through “devices and services”

When I go to see this integration up, it asks for a host (ip address), username, and password. In the host section I’m punching in my default gateway IP to the console, then my username and password.

PROBLEM:
When I do the above and click “submit” it says “unknown error occurred”. If I intentionally use the wrong user or password then it tells me it’s wrong, so I know it’s either an IP address issue, port number issue (I’m using port 443), or the integration is broke.

Any ideas? Do I need to forward port 443 to my console?

FYI: everything is up to date with latest version of everything and I tried restarting multiple times.

1 Like
2

Have you got a unifi controller, eg a UDM Pro ? If so you don’t need the addon

3

@Holdestmade Yes, I have the UDM Pro SE.

The reason why I wanted to download it is because I previous had an ASUS Zen Wifi ET12 router and I had some of the entities / info listed on cards.

So you’re saying the integration is essentially to substitute for a controller, and theres no way to add it any info about it to HA using one of the integrations?

Thanks so much for your reply.

4

The UDM already is the controller of you Unifi network, so no need to install a second controller on you HA installation.

Just add this UniFi Network - Home Assistant integration to your HA installation and configure it.

For the host, add the ip-adress of your UDM, likely 192.168.1.1, enter your credentials and follow the installation wizard.

After that you have a working Unifi integration in HA.

You can then use all entities from that integration to visualize in cards or use the entity tracker to create some cool automations when a mobile devices moves into of out of the network.

2 Likes
5

Further to this, I believe you need to make sure you set up a local user in UniFi and use those credentials.

1 Like
6

Good addition, you can use the same user in HA that can access the UDM.

7

The Unifi Integration docs says a local-only user needs to be used:

I use a new, separate user in Unifi so I can see in the unifi logs when homeassistant makes any changes/logs in etc

Screenshot 2024-01-24 111735
Screenshot 2024-01-24 1117351509×313 41 KB

1 Like
8

The integration you posted is the one im trying to add. Thats the one that is giving me issues.

9

Have you removed the add-on first before installing the integration ?

10

There may be some confusion…

the add-on is a Unifi controller. You don’t need the add-on since you already have the UDM which is the controller.

remove the add-on as it’s redundant and not needed.

the integration connects to the controller. So you need to create a local user on the UDM and then configure the integration to use the IP of the UDM and the local user/password.

1 Like
11

Hi, I was just wanting to confrim if the HA Ubiquit Integration works with the SE version of the UDM. Just had my UDR fail and now looking to upgrade to the UDM SE. Hoping it works the same or better than the UDR. Unortunate that we cant get SNMP info from the Ubiquiti devices.
Cheers Danny

12

Yes its the same software

13

Thanks for confirming Robban

1 Like
14

Hi all, my unifi system this morning asked me to use 2-factor authentication (TOP), basically the integration has stopped working and is asking me to log in again which, of course, doesn’t work because it doesn’t have the TOP field.

Any ideas?

Thank you very much

EDIT:=====

I answer myself, you have to use only local accounts and not cloud accounts because they require MFA.

1 Like
15

Spread the word! :clap:t2:

16

I have the same issue after 2 factor identification with mobile phone authentication.
I think I am using local account, but I maybe mistaken.

Can you please elaborate a bit?

Thanks

17

You need to have a super admin user on your controller software. This user can be used within the integration inside HA.

To do this follow the next steps:

  1. Log in to your UniFi controller, go to Admin & Users.
  2. Select the + for adding an Admin.
  3. Select Restrict to local access only
  4. Provide an username and a password
  5. Select Use a pre-defined role
  6. Select Super Admin
  7. Select Add

Now head over to your Home Assistant and add the integration, provide the just created Super Admin credentials for the integration.

And your done!

2 Likes
18

@DotNet2Web

Thanks a lot. It worked

19

I have a udm pro, i use the unify integration to expose entities, thats alll wroking fine, but there was some additional dashboard which i cannot seem to get working, does anyone have this working My Unifi Dream Machine control Dashboard : r/Ubiquiti (reddit.com)

20

I do not have “super admin” role to pick. I have “Administrator”
am I doing it wrong?