Configurer le gateway Index AMI depuis Linux : AppImage sans dépendances

Quand utiliser l'outil de bureau ?

L'application Android couvre la configuration sur le terrain : rapide, sans fil, idéale pour les techniciens d'installation. L'outil de bureau ajoute des capacités que l'application n'a pas : préparer des modèles de configuration pour plusieurs unités avant de partir sur le terrain, récupérer et restaurer des configurations depuis un fichier conf.json, et accéder à des journaux de session détaillés pour un diagnostic avancé. C'est aussi la seule option si l'ordinateur ne dispose pas de Bluetooth ou si le flux de travail nécessite une automatisation.

Index AMI Configuration Tool est distribué pour Linux sous forme d'AppImage — un exécutable portable qui fonctionne sur n'importe quelle distribution x86_64 sans installation. Ce guide couvre tout, du téléchargement à la première connexion.

Prérequis

• Linux x86_64 (Arch, Ubuntu, Debian, Fedora, openSUSE, etc.)
• ~100 Mo d'espace disque libre
• Pour Bluetooth / BLE: service bluetoothd actif + Python 3 + bibliothèque bleak

Installer bleak pour Bluetooth (BLE)

Nécessaire uniquement si vous utilisez l'onglet "Configurer l'appareil". Le reste de l'application fonctionne sans Python.

# Vérifier que Python 3 est installé
python3 --version

# Arch Linux
pip install bleak

# Ubuntu / Debian
pip3 install bleak
# En cas d'erreur PEP 668 :
pipx install bleak

# Fedora
pip3 install bleak

# Vérifier l'installation
python3 -c "import bleak; print('bleak OK')"

Si le Bluetooth n'apparaît pas actif dans l'application, vérifiez le service :

systemctl status bluetooth

Option A — Portable (recommandé)

La méthode la plus simple : téléchargez l'AppImage, rendez-le exécutable et lancez-le depuis n'importe quel dossier.

chmod +x IndexAmiConfig-1.0.1-x86_64.AppImage
./IndexAmiConfig-1.0.1-x86_64.AppImage

L'application s'ouvre immédiatement. Elle ne modifie pas le système et ne nécessite pas les droits root.

Option B — Installation avec raccourci dans le menu

Si vous préférez que l'application apparaisse dans le menu de recherche du système et sur le bureau :

# 1. Rendre exécutable
chmod +x IndexAmiConfig-1.0.1-x86_64.AppImage

# 2. Créer les répertoires
mkdir -p ~/.local/bin/ ~/.local/share/applications/ ~/Desktop/

# 3. Copier l'application
cp IndexAmiConfig-1.0.1-x86_64.AppImage ~/.local/bin/IndexAmiConfig
chmod +x ~/.local/bin/IndexAmiConfig

# 4. Extraire l'icône de l'AppImage
./IndexAmiConfig-1.0.1-x86_64.AppImage --appimage-extract
mkdir -p ~/.local/share/icons/hicolor/256x256/apps/
cp squashfs-root/index-ami-config.png ~/.local/share/icons/hicolor/256x256/apps/
rm -rf squashfs-root/

# 5. Créer l'entrée de menu
cat > ~/.local/share/applications/IndexAmiConfig.desktop << EOF
[Desktop Entry]
Version=1.0
Type=Application
Name=Index AMI Configuration Tool
Exec=/home/$(whoami)/.local/bin/IndexAmiConfig
Icon=index-ami-config
Categories=Utility;System;
Terminal=false
EOF

# 6. Mettre à jour le cache
update-desktop-database ~/.local/share/applications/

Première connexion

⚠ Changez le mot de passe immédiatement après la première connexion : Settings → Compte utilisateur → Enregistrer les identifiants.

Désinstallation

Vos données sont conservées par défaut. Si vous réinstallez l'application, tous vos modèles et configurations sont restaurés automatiquement.

Si vous avez utilisé l'Option A (portable) :

rm IndexAmiConfig-1.0.1-x86_64.AppImage
# (Optionnel) Supprimer les données :
rm -rf ~/.config/IndexAmiConfig/

Si vous avez utilisé l'Option B (installé sur le système) :

killall IndexAmiConfig 2>/dev/null || true
rm ~/.local/bin/IndexAmiConfig
rm ~/.local/share/applications/IndexAmiConfig.desktop
rm ~/.local/share/icons/hicolor/256x256/apps/index-ami-config.png
update-desktop-database ~/.local/share/applications/
# (Optionnel) Supprimer les données :
rm -rf ~/.config/IndexAmiConfig/

Notes

• Hors ligne: l'application fonctionne sans connexion Internet.
• Données: stockées dans ~/.config/IndexAmiConfig/ et conservées lors de la désinstallation.
• Export: les fichiers conf.json sont enregistrés dans ~/Downloads/ par défaut.

Vous utilisez Windows ? Consultez le guide d'installation pour Windows.