Installation du controleur Unifi sur Debian¶

1. Sommaire¶

• 1. Sommaire
• 2. Contexte
• 3. Installation des dépendances
• 4. Téléchargement de l'installeur
• 5. Exécution de l'installeur

2. Contexte¶

Le contrôleur UniFi OS centralise la gestion et le monitoring des équipements réseaux Ubiquiti (points d'accès, switchs). Déployé sur Debian, il repose sur Podman pour conteneuriser ses services, assurant ainsi une isolation sécurisée et facilitant les mises à jour sans impacter l'OS hôte.

3. Installation des dépendances¶

3.1. Mise à jour et installation des paquets requis. Actualise les dépôts et installe les composants nécessaires à la conteneurisation du service.

sudo apt-get update && sudo apt-get install podman slirp4netns

• sudo : Exécute la commande avec les privilèges administrateur (root).
• apt-get update : Met à jour la liste locale des paquets disponibles depuis les dépôts.
• apt-get install : Installe les paquets spécifiés en argument.
• podman : Moteur de conteneurs sans démon central (daemonless), utilisé ici pour isoler UniFi OS.
• slirp4netns : Outil gérant la mise en réseau des conteneurs Podman lancés dans l'espace utilisateur (rootless).

4. Téléchargement de l'installeur¶

4.1. Récupération du binaire. Télécharge l'archive exécutable du serveur UniFi OS depuis les serveurs officiels. Lien vers UNIFI RELEASE.

cd /tmp
curl -O https://fw-download.ubnt.com/data/unifi-os-server/5172-linux-x64-5.1.42-12e9e3cf-8f8b-4e54-928c-76b80a10c8a4.42-x64

• curl : Outil en ligne de commande de transfert de données réseau.
• -O : Option (majuscule) ordonnant à curl de sauvegarder le fichier avec le même nom que sur le serveur distant.

5. Exécution de l'installeur¶

5.1. Ajout des droits et lancement. Rend le binaire téléchargé exécutable, puis initie le processus de déploiement.

chmod +x 5172-linux-x64-5.1.42-12e9e3cf-8f8b-4e54-928c-76b80a10c8a4.42-x64
sudo ./5172-linux-x64-5.1.42-12e9e3cf-8f8b-4e54-928c-76b80a10c8a4.42-x64

• chmod : Commande Unix permettant de modifier les permissions d'un fichier.
• +x : Ajoute le droit d'exécution au fichier ciblé.
• ./ : Spécifie au shell d'exécuter le fichier présent dans le répertoire courant.

6. Post-installation¶

6.1 Vérification du fonctionnement du service uosserver. Vérifier le bon fonctionnement du contrôleur au près du service uosserver sur Debian.

sudo systemctl status uosserver

Résultat attendu :

● uosserver.service - UniFi OS Server Service
     Loaded: loaded (/etc/systemd/system/uosserver.service; enabled; preset: enabled)
     Active: active (running) since Tue 2026-09-22 19:06:51 CEST; 2min 44s ago
 Invocation: cc5a1db737654752bd0a4ae6e986b24c
   Main PID: 951 (uosserver-servi)
      Tasks: 8 (limit: 2252)
     Memory: 59.3M (peak: 93.4M, swap: 3.6M, swap peak: 3.6M)
        CPU: 850ms
     CGroup: /system.slice/uosserver.service
             ├─ 951 /var/lib/uosserver/bin/uosserver-service
             └─1100 /var/lib/uosserver/bin/discovery

6.2. Connexion à l'interface Finalisation de l'intégration dans l'infrastructure via l'interface UI https://<votre-ip>:11443.

6. Ressources¶

• Self-Hosting UniFi