Play o Sideload
Compara actualizaciones automáticas con Device Control opcional.
Instalación y configuración
Esta es la referencia detallada para elegir versión, conectar manualmente, configurar acceso remoto y revisar la seguridad. Si Hermes Dashboard ya es accesible, usa el Inicio rápido.
Usa esta página cuando el inicio rápido no encaje.
Haz accesible Hermes
Instala Hermes, activa Dashboard o configura el API opcional.
Conecta sin QR
Usa LAN, direcciones, códigos, acceso remoto y verificación.
Estado de la traducción
Esta guía resumida cubre la ruta habitual. Las opciones avanzadas de servidor, TLS y operación están en la guía completa en inglés.
1. Elige la aplicación
| Google Play | Sideload | |
|---|---|---|
| Recomendado para | La mayoría de usuarios | Usuarios de Device Control |
| Actualizaciones | Automáticas | Actualización manual del APK |
| Chat, Voice y Manage | Incluidos | Incluidos |
| Terminal, multimedia y notificaciones con Relay | Incluidos | Incluidos |
| Leer la pantalla, tocar, escribir y navegar | No incluido | Incluido |
El archivo firmado de Sideload termina en -sideload-release.apk y se publica en GitHub Releases. No descargues el archivo .aab; está destinado a Google Play.
2. Haz que Hermes sea accesible
Android usa normalmente el Dashboard/Gateway de Hermes en :9119. Proporciona Chat, sesiones, inicio de sesión, Manage y voz estándar. Inícialo con hermes dashboard y haz que esa dirección sea accesible desde el teléfono.
El servidor de API en :8642 es opcional: sirve como fallback automático de Chat o para compatibilidad headless avanzada. Solo necesitas una clave de API si configuras ese endpoint opcional. El operador del servidor crea API_SERVER_KEY; el Dashboard no proporciona esa clave.
Protege el acceso de red
No expongas directamente a Internet un puerto de Dashboard, API o Relay sin cifrar; para el acceso remoto utiliza Tailscale, una VPN o HTTPS.
El inicio de sesión del dashboard usa cookies y tickets efímeros del Gateway. La clave de API es independiente y no inicia sesión en el dashboard.
3. Conecta y conversa
- Abre Connect en Android.
- Busca Hermes en la LAN, introduce la URL del Dashboard/Gateway o escanea un QR; los QR API-first antiguos siguen siendo compatibles.
- Inicia sesión en el dashboard cuando se solicite.
- Pulsa Connect y comprueba Chat · Ready.
- En Finalizar configuración, activa las notificaciones de Android si quieres alertas de chat en segundo plano. La cámara, el micrófono y las demás funciones siguen siendo opcionales y se configuran una a una; pulsa Ahora no para continuar directamente.
- Añade API fallback, Relay o rutas remotas después desde Advanced si lo necesitas.
Puedes añadir y probar una dirección Dashboard de Tailscale como http://100.x.y.z:9119, o una dirección .ts.net publicada por separado, sin configurar el servidor API ni una clave API.
La misma sesión habilita Chat, sesiones, Manage y Voice. Es normal que Relay esté sin emparejar y que API fallback no esté disponible.
Recomendado: completa la configuración con Relay
El recorrido upstream sigue funcionando sin plugin. Relay se recomienda para Terminal/TUI, notificaciones, multimedia, herramientas de escritorio, voz mejorada, sesiones Relay y Device Control opcional. Los comandos canónicos son hermes plugins install Codename-11/hermes-relay/plugin --enable, hermes relay doctor, hermes relay start --no-ssl y hermes pair.
En el Web Dashboard, abre Relay, usa primero Connect mobile app y luego Pair new device, y escanea ambos QR con Android. Si no puedes usar QR, siguen disponibles la entrada de URL/código y hermes pair --register-code.
Device Control necesita las dos cosas: la aplicación Sideload y un Relay emparejado.
Comparar versiones → · Acceso remoto en inglés → · Solución de problemas →