Configurar el gateway Index AMI desde Linux: AppImage sin dependencias

¿Cuándo usar la herramienta de escritorio?

La app Android cubre la configuración en campo: rápida, sin cables, ideal para técnicos de instalación. La herramienta de escritorio añade capacidades que la app no tiene: preparar plantillas de configuración para múltiples unidades antes de salir a campo, recuperar y restaurar configuraciones desde archivo conf.json, y acceder a logs de sesión detallados para diagnóstico avanzado. También es la única opción si el equipo no dispone de Bluetooth o si el flujo de trabajo requiere automatización.

Index AMI Configuration Tool se distribuye para Linux como un AppImage — un ejecutable portátil que funciona en cualquier distribución x86_64 sin instalación. Esta guía cubre desde la descarga hasta el primer inicio de sesión.

Requisitos

• Linux x86_64 (Arch, Ubuntu, Debian, Fedora, openSUSE, etc.)
• ~100 MB de espacio libre en disco
• Para Bluetooth / BLE: servicio bluetoothd activo + Python 3 + librería bleak

Instalar bleak para Bluetooth (BLE)

Solo necesario si vas a usar el tab «Configurar dispositivo». El resto de la app funciona sin Python.

# Verificar que Python 3 está instalado
python3 --version

# Arch Linux
pip install bleak

# Ubuntu / Debian
pip3 install bleak
# Si falla con error PEP 668:
pipx install bleak

# Fedora
pip3 install bleak

# Verificar instalación
python3 -c "import bleak; print('bleak OK')"

Si el Bluetooth no aparece activo en la app, verifica el servicio:

systemctl status bluetooth

Opción A — Portátil (recomendado)

La forma más simple: descarga el AppImage, hazlo ejecutable y ejecútalo desde cualquier carpeta.

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

La app abre inmediatamente. No modifica el sistema ni requiere permisos de root.

Opción B — Instalación con acceso directo en menú

Si prefieres que la app aparezca en el menú de búsqueda del sistema y en el Desktop:

# 1. Hacer ejecutable
chmod +x IndexAmiConfig-1.0.0-x86_64.AppImage

# 2. Crear directorios
mkdir -p ~/.local/bin/ ~/.local/share/applications/ ~/Desktop/

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

# 4. Extraer ícono del AppImage
./IndexAmiConfig-1.0.0-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. Crear entrada en menú
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. Actualizar caché
update-desktop-database ~/.local/share/applications/

Primer login

⚠ Cambia la contraseña inmediatamente tras el primer login: Settings → Cuenta de usuario → Guardar credenciales.

Desinstalación

Tus datos se conservan por defecto. Si reinstala la app, recupera todas tus plantillas y configuraciones automáticamente.

Si usaste Opción A (portátil):

rm IndexAmiConfig-1.0.0-x86_64.AppImage
# (Opcional) Eliminar datos:
rm -rf ~/.config/IndexAmiConfig/

Si usaste Opción B (instalada en sistema):

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/
# (Opcional) Eliminar datos:
rm -rf ~/.config/IndexAmiConfig/

Notas

• Offline: la app funciona sin conexión a internet.
• Datos: se guardan en ~/.config/IndexAmiConfig/ y se conservan al desinstalar.
• Exportación: los archivos conf.json se guardan en ~/Downloads/ por defecto.

¿Usas Windows? Consulta la guía de instalación para Windows.