Instalar TigerMole en Linux

Descarga

• tigermole-proxy-X.X.X-amd64.deb: recomendado para Ubuntu / Debian
• tigermole-proxy-X.X.X-linux-x86_64.tar.gz: otras distribuciones

Comprueba el checksum SHA-256 antes de instalar:

Copiarsha256sum -c tigermole-proxy-X.X.X-amd64.deb.sha256

Instalar con .deb (Ubuntu / Debian, recomendado)

Copiarsudo dpkg -i tigermole-proxy-X.X.X-amd64.deb

El binario se instala en /usr/bin/tigermole-proxy. El paquete no inicia nada ni registra el inicio automático; deja la activación para el siguiente paso:

Copiartigermole-proxy install

Dependencias de ejecución: libgtk-3-0 y libayatana-appindicator3-1. Si falta alguna en un sistema mínimo:

Copiarsudo apt-get install -y libgtk-3-0 libayatana-appindicator3-1

Instalar con tarball (otras distribuciones)

Copiartar -xzf tigermole-proxy-X.X.X-linux-x86_64.tar.gz
./tigermole-proxy install

El asistente de instalación

tigermole-proxy install detecta el entorno y usa Zenity si hay escritorio, o el asistente CLI en servidores, SSH y WSL.

Paso 1: Acuerdo de licencia

Lee y acepta el EULA para continuar. Cancelar aborta la instalación.

Paso 2: Activación de licencia (obligatoria)

El asistente solicita la clave y no permite continuar hasta que la activación sea correcta o canceles. La licencia se cifra localmente en ~/.local/share/TigerMole/.masterkey.

Ejemplo del asistente CLI

CopiarLicense key (or type 'cancel' to abort): key/AAAA....BBBB
Owner / machine label (optional, Enter to skip): mi-portatil
  Validating key ... OK
  [OK] License: Team  (2/5 seats)

Paso 3: Opciones

Puedes registrar el inicio automático. En licencias Team o Custom, la clave pública X25519 para cifrar logs es obligatoria.

Paso 4: Instalación

El asistente copia el binario, registra el inicio, configura ANTHROPIC_BASE_URL, activa la licencia, importa la clave de auditoría y lanza la bandeja.

Paso 5: Resumen

Confirma el resultado, el nivel, los puestos, la ruta del binario y cómo desinstalar.

Instalación no interactiva

Para CI o aprovisionamiento, encadena los subcomandos y evita el asistente interactivo:

Copiarset -euo pipefail

sudo dpkg -i tigermole-proxy-X.X.X-amd64.deb
tigermole-proxy activate "$TIGERMOLE_LICENSE_KEY"
tigermole-proxy configure
tigermole-proxy import-audit-key /path/to/team.pub
tigermole-proxy run &

No canalices respuestas preparadas al asistente install: sus prompts de licencia pueden bloquearse con stdin cerrado. Usa activate y configure de forma explícita.

Servicio systemd (recomendado para servidores)

En procesos sin sesión gráfica, registra TigerMole como servicio systemd de usuario. Consulta la referencia de despliegue headless para el archivo .service.

Comprobar la instalación

Copiartigermole-proxy doctor
tigermole-proxy status
tigermole-proxy license

Salida esperada de doctor:

CopiarTigerMole - Comprobación de instalación
  [OK] Todas las comprobaciones correctas.

Desinstalar

Copiartigermole-proxy uninstall      # libera el puesto y limpia datos
sudo dpkg -r tigermole-proxy   # elimina el paquete

Solución de problemas

No aparece el icono de la bandeja

Comprueba que el escritorio soporte StatusNotifierItem / AppIndicator y revisa el proceso con pgrep -a tigermole-proxy.

No se encuentra zenity

Instala Zenity con sudo apt-get install -y zenity y vuelve a ejecutar tigermole-proxy install.

La activación falla por límite de puestos

En otro equipo con TigerMole ejecuta tigermole-proxy deactivate y reintenta la activación.