Index AMI Gateway unter Linux konfigurieren: AppImage ohne Abhängigkeiten

Wann das Desktop-Tool verwenden?

Die Android-App deckt die Feldkonfiguration ab: schnell, kabellos, ideal für Installationstechniker. Das Desktop-Tool fügt Funktionen hinzu, die die App nicht bietet: Konfigurationsvorlagen für mehrere Einheiten vor dem Feldeinsatz vorbereiten, Konfigurationen aus conf.json-Dateien wiederherstellen und detaillierte Sitzungsprotokolle für erweiterte Diagnose abrufen. Es ist auch die einzige Option, wenn der Computer kein Bluetooth hat oder der Workflow eine Automatisierung erfordert.

Index AMI Configuration Tool wird für Linux als AppImage bereitgestellt — eine portable ausführbare Datei, die auf jeder x86_64-Distribution ohne Installation funktioniert. Diese Anleitung führt Sie vom Download bis zur ersten Anmeldung.

Voraussetzungen

• Linux x86_64 (Arch, Ubuntu, Debian, Fedora, openSUSE, etc.)
• ~100 MB freier Speicherplatz
• Für Bluetooth / BLE: aktiver bluetoothd-Dienst + Python 3 + Bibliothek bleak

bleak für Bluetooth (BLE) installieren

Nur erforderlich, wenn Sie die Registerkarte "Gerät konfigurieren" verwenden möchten. Der Rest der App funktioniert ohne Python.

# Python 3 Installation prüfen
python3 --version

# Arch Linux
pip install bleak

# Ubuntu / Debian
pip3 install bleak
# Bei PEP 668-Fehler:
pipx install bleak

# Fedora
pip3 install bleak

# Installation prüfen
python3 -c "import bleak; print('bleak OK')"

Falls Bluetooth in der App nicht aktiv erscheint, prüfen Sie den Dienst:

systemctl status bluetooth

Option A — Portabel (empfohlen)

Die einfachste Methode: laden Sie das AppImage herunter, machen Sie es ausführbar und starten Sie es aus einem beliebigen Ordner.

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

Die App öffnet sich sofort. Sie verändert das System nicht und benötigt keine Root-Rechte.

Option B — Installation mit Menüeintrag

Wenn Sie möchten, dass die App im Systemsuchmenü und auf dem Desktop erscheint:

# 1. Ausführbar machen
chmod +x IndexAmiConfig-1.0.1-x86_64.AppImage

# 2. Verzeichnisse erstellen
mkdir -p ~/.local/bin/ ~/.local/share/applications/ ~/Desktop/

# 3. App kopieren
cp IndexAmiConfig-1.0.1-x86_64.AppImage ~/.local/bin/IndexAmiConfig
chmod +x ~/.local/bin/IndexAmiConfig

# 4. Icon aus dem AppImage extrahieren
./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. Menüeintrag erstellen
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. Cache aktualisieren
update-desktop-database ~/.local/share/applications/

Erste Anmeldung

⚠ Ändern Sie das Passwort sofort nach der ersten Anmeldung: Settings → Benutzerkonto → Zugangsdaten speichern.

Deinstallation

Ihre Daten bleiben standardmäßig erhalten. Nach einer Neuinstallation werden alle Vorlagen und Konfigurationen automatisch wiederhergestellt.

Bei Option A (portabel):

rm IndexAmiConfig-1.0.1-x86_64.AppImage
# (Optional) Daten löschen:
rm -rf ~/.config/IndexAmiConfig/

Bei Option B (im System installiert):

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/
# (Optional) Daten löschen:
rm -rf ~/.config/IndexAmiConfig/

Hinweise

• Offline: die App funktioniert ohne Internetverbindung.
• Daten: gespeichert in ~/.config/IndexAmiConfig/ und bei Deinstallation erhalten.
• Export: conf.json -Dateien werden standardmäßig in ~/Downloads/ gespeichert.

Verwenden Sie Windows? Lesen Sie die Windows-Installationsanleitung.