Configure the Index AMI Gateway from Linux: AppImage, No Dependencies

When to use the desktop tool?

The Android app covers field configuration: fast, wireless, ideal for installation technicians. The desktop tool adds capabilities the app does not have: preparing configuration templates for multiple units before heading to the field, recovering and restoring configurations from conf.json files, and accessing detailed session logs for advanced diagnostics. It is also the only option if the computer does not have Bluetooth or if the workflow requires automation.

Index AMI Configuration Tool is distributed for Linux as an AppImage — a portable executable that runs on any x86_64 distribution without installation. This guide covers everything from download to first login.

Requirements

• Linux x86_64 (Arch, Ubuntu, Debian, Fedora, openSUSE, etc.)
• ~100 MB of free disk space
• For Bluetooth / BLE: active bluetoothd service + Python 3 + bleak library

Install bleak for Bluetooth (BLE)

Only needed if you plan to use the "Configure device" tab. The rest of the app works without Python.

# Verify Python 3 is installed
python3 --version

# Arch Linux
pip install bleak

# Ubuntu / Debian
pip3 install bleak
# If it fails with PEP 668 error:
pipx install bleak

# Fedora
pip3 install bleak

# Verify installation
python3 -c "import bleak; print('bleak OK')"

If Bluetooth doesn't appear active in the app, check the service:

systemctl status bluetooth

Option A — Portable (recommended)

The simplest approach: download the AppImage, make it executable, and run it from any folder.

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

The app opens immediately. It does not modify the system or require root privileges.

Option B — Install with application menu shortcut

If you prefer the app to appear in the system search menu and on the desktop:

# 1. Make executable
chmod +x IndexAmiConfig-1.0.1-x86_64.AppImage

# 2. Create directories
mkdir -p ~/.local/bin/ ~/.local/share/applications/ ~/Desktop/

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

# 4. Extract icon from 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. Create menu entry
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. Update cache
update-desktop-database ~/.local/share/applications/

First login

⚠ Change the password immediately after the first login: Settings → User account → Save credentials.

Uninstall

Your data is preserved by default. If you reinstall the app, all your templates and configurations are automatically restored.

If you used Option A (portable):

rm IndexAmiConfig-1.0.1-x86_64.AppImage
# (Optional) Delete data:
rm -rf ~/.config/IndexAmiConfig/

If you used Option B (system install):

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) Delete data:
rm -rf ~/.config/IndexAmiConfig/

Notes

• Offline: the app works without an internet connection.
• Data: stored in ~/.config/IndexAmiConfig/ and preserved on uninstall.
• Export: conf.json files are saved to ~/Downloads/ by default.

Using Windows? See the Windows installation guide.