Ce tutoriel va vous permettre d'installer simplement le contrôleur Unifi d'Ubiquiti sur un système Armbian Bullseye pour plateforme ARM 64 bits (alias AArch64).

Si vous êtes arrivé ici par hasard, ce logiciel permet de gérer les points d'accès Wi-Fi de la gamme Unifi de manière centralisée avec une interface graphique facile à utiliser. Officiellement, l'architecture AArch64 n'est pas supportée par Unifi, mais heureusement pour nous, c'est un programme Java, donc sans dépendance à l'architecture matérielle.

Personnellement, j'ai réalisée cette installation sur un SBC Rock64 mais cela devrait fonctionner pour n'importe quel autre plateforme AArch64.

Prérequis

Tout d'abord, mettez votre système à jour :

sudo apt update
sudo apt upgrade

Point important avant de continuer, que j'ai appris à mes dépends : vous ne devez pas avoir d'utilisateur identifié unifi sur votre système !

Gestion des dépendances

Comme dit précédemment, le contrôleur Unifi repose sur Java, en version 8. Il a également besoin d'une version de MongoDB assez ancienne, non disponible sur Bullseye, mais disponible dans Stretch.

Installer MongoDB depuis Stretch

Nous allons forcer APT à aller récupérer MongoDB depuis le dépôt de Stretch afin de satisfaire la dépendance d'Unifi. Pour cela, on ajoute le dépôt de Stretch mais en précisant de ne jamais préférer ses paquets par rapport aux autres dépôts configurés sur le système.

echo -e '# Never prefer packages from Stretch\nPackage: *\nPin: release n=stretch\nPin-Priority: 1' | sudo tee /etc/apt/preferences.d/99stretch-mongodb.pref
echo 'deb http://deb.debian.org/debian stretch main' | sudo tee /etc/apt/sources.list.d/stretch_mongodb.list

Ajout du dépôt officiel d'Ubiquiti

Nous devons ajouter le dépôt officiel d'Ubiquiti. Mais avant, nous devons télécharger et enregistrer la clé GPG associée. Nous allons également demander à APT de récupérer la liste des paquets pour les architectures ARM 32 et 64 bits sur le dépôt d'Ubiquiti, afin d'outrepasser la restriction d'architecture citée plus haut.

curl https://dl.ui.com/unifi/unifi-repo.gpg | sudo tee /usr/share/keyrings/ubiquiti-archive-keyring.gpg >/dev/null
echo 'deb [arch=arm64,armhf signed-by=/usr/share/keyrings/ubiquiti-archive-keyring.gpg] https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list

Installation

Bien, maintenant tout est prêt ! Une dernière mise à jour du cache d'APT et nous pouvons lancer l'installation.

sudo apt update
sudo apt install openjdk-8-jre-headless unifi

Rendez vous sur https://[IP ou FQDN de votre système]:8443/ pour configurer et utiliser votre installation d'Unifi !