UniFi Controller for RHEL (yum-based distros)

Ansible Galaxy role for installing UniFi Controller software for Ubiquiti Access Points on RedHat/Centos/Amazon/Fedora and other yum-based distros.

WARNING: This has only been tested on Amazon Linux so far, and may have issues in /etc/yum.repos.d/mongodb-org-3.2.repo for Fedora (probably need to use the /redhat/ mongo repo.) If you install this on any other distro besides Amazon Linux please comment with your experiences.

Forked from https://github.com/fukawi2/unifi-controller-rhel and modified to be an includable role via Galaxy instead of a playbook.

Requirements

Ubiquiti's license does not allow redistribution of the software ZIP, so you must manually download the ZIP of the UniFi Controller software from the Ubiquiti website and save it to files/UniFi.unix.zip. The most recent tested version is "UniFi v5.0.6 Zip for DIY Unix/Linux" from 2016-06-01. If you are including this role via Galaxy, you may download this file to your playbook's files directory instead of this role's files directory; you may also download to an arbitrary folder in your playbook and specify the relative path in the variable.
You may need the EPEL Repository from Fedora Project enabled for some packages, however Mongo is installed directly from mongo.org so try running without first.

Role Variables

unifi_controller_rhel_ntp_server (optional) sets your preferred NTP server for the UniFi APs to use (default: pool.ntp.org)
unifi_controller_rhel_ssl_bundle (optional) provides an alternate SSL CA certificate bundle/chain for the Controller to use. (default: none)
unifi_controller_rhel_ssl_cert (optional) provides an alternate SSL certificate for the Controller to use. (default: none)
unifi_controller_rhel_ssl_key (optional) provides an alternate SSL key for the Controller to use. (default: none)
unifi_controller_rhel_unifi_zip_file (optional) sets the filename of the UniFi controller software on the Ansible system, can be a path relative to your playbook like roles/my_other_role/downloads/Unifi.unix.zip (default: UniFi.unix.zip)

Dependencies

n/a

Example Playbook

First, install this role via Galaxy by typing sudo ansible-galaxy install zyphlar.unifi_controller_rhel

Then create and run an Ansible playbook like this:

- hosts: your_unifi_controllers
  become: true
  roles:
    - zyphlar.unifi_controller_rhel

Or, if you want to override some variables:

- hosts: your_unifi_controllers
  become: true
  roles:
    - some_other_role
    - role: zyphlar.unifi_controller_rhel
      unifi_controller_rhel_unifi_zip_file: UniFi.unix.5.0.6.zip

License

BSD

Support

There is none. Tested on CentOS 6 x86_64. Not tested on animals.

Your results may vary. Discontinue use and see a doctor if rash occurs.

Author Information

fukawi2 (Original)
zyphlar (Ansible Galaxy version)

TODO

Possibly open up ports in iptables if it's enabled by default in some distros:

-A INPUT -m state --state NEW -m tcp -p tcp --dport 8081 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8443 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8843 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8880 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 27117 -j ACCEPT

# service iptables restart

3.7 KiB Raw Blame History