---
id: "sistema.ssh-hosts"
titulo: "Hosts SSH"
resumo: "Registre las máquinas a las que accede por SSH y conéctese a ellas desde la app."
idioma: "es"
tipo: "guia"
categoria: "ambientes"
aplicavelDesde: "0.0.16"
capabilities: ["environment.ssh.hosts"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/sistema/ssh-hosts/"
fonte: "pt-br/sistema/ssh-hosts.md"
caminhoPublico: "docs/publica/es/sistema/ssh-hosts.md"
hashFonte: "sha256:15d925dba9c6bf1c69e61dadbd724e830931f1dd2bb502c2208b2fd8d9d2ea88"
hashDestaPagina: "sha256:70810a78c6eda2a58c8f292ab9fb044bc0c58c8dc2d4e57ef8363aae585d7bec"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/sistema/ssh-hosts.md fonteHash=sha256:15d925dba9c6bf1c69e61dadbd724e830931f1dd2bb502c2208b2fd8d9d2ea88 estado=atual -->

Un **host SSH** es una máquina a la que Elyra accede por la red para ejecutar el trabajo pesado: el
proyecto, las terminales y los comandos de Git ocurren **en el host**, no en su computadora. Registrar el
host es el paso que permite abrir un proyecto remoto, crear un workspace remoto y usar la terminal allí.

## Cuándo usarlo

- El proyecto vive en una máquina de desarrollo, un VPS o un servidor de compilación.
- Quiere la potencia del servidor (CPU, memoria, GPU, entorno ya preparado) manteniendo la app en su
  escritorio.
- Prefiere no clonar el repositorio otra vez en su computadora.

## Requisitos previos

- La app instalada y con licencia activa.
- Acceso de red desde su computadora hasta el host.
- Autenticación SSH ya resuelta en su computadora — la app reutiliza lo que su SSH ya sabe.
- En el host: un sistema donde el auxiliar de Elyra pueda ejecutarse. Windows, macOS y Linux están en el
  conjunto de plataformas soportadas.

## Registrar un host

1. Abra **Ajustes > Conexões > Hosts SSH** (Ajustes > Conexiones > Hosts SSH).
2. Elija una de las dos entradas:
   - **Importar de `~/.ssh/config`** — la app lee los hosts que usted ya configuró y los trae a la lista.
     Es el camino recomendado cuando su SSH ya funciona en la terminal.
   - **Añadir** — registre un host nuevo indicando el destino.
3. Ajuste lo que necesite y guarde.
4. En la fila del host, use **Connect** para abrir la conexión, **Test** para comprobar el acceso sin
   entrar en el flujo de trabajo y **Edit** para corregir el registro.

Lo que el registro guarda es la configuración del host. La conexión en sí se abre y se cierra con los
botones **Connect** y **Disconnect**.

## La primera conexión a un host limpio

La primera conexión suele ser la más lenta, porque casi todo el trabajo ocurre del otro lado. La app
instala un **auxiliar versionado** en el home del host, en `~/.elyra-remote/`, y mantiene ese auxiliar en
ejecución para que las terminales sobrevivan a una caída del SSH.

Si el host no tiene compilador, `make` ni Python, la instalación de los módulos nativos falla. En ese caso
la app:

1. comprueba qué falta en el host;
2. arma el comando del gestor de paquetes detectado — directo si la cuenta es `root`, y con `sudo -n` si
   no lo es;
3. **pregunta una vez, mostrando el comando exacto que se ejecutará**;
4. si usted acepta, reintenta la instalación y continúa; si rechaza, muestra el comando para que lo
   ejecute a mano.

La respuesta se recuerda por host, así que la pregunta no vuelve en cada conexión. Sin nadie para
responder — un proceso automático, por ejemplo — la respuesta es siempre no.

## Mientras la conexión avanza

Mientras el host conecta, su tarjeta muestra **en qué paso** está la conexión. Esa información existe
porque conectar a un host nuevo puede tardar de uno a tres minutos, y sin ella una conexión que avanza es
indistinguible de una trabada.

Una vez conectado, la tarjeta vuelve a hablar de sincronización del workspace, no del paso de la conexión.

## Resultado

- El host aparece conectado en **Ajustes > Conexões > Hosts SSH**.
- Queda disponible para **Añadir proyecto > Otra máquina (SSH)** y para nuevos workspaces con destino SSH.
- Terminal, archivos y Git de las sesiones de ese host se ejecutan en la máquina remota.

## Límites

- **Cada forma de autenticación depende de su SSH.** La app reutiliza la configuración existente; cuando la
  autenticación exige interacción específica, usa el binario `ssh` del sistema.
- **Registrar un host no garantiza que esté disponible.** Un host guardado no es un host en línea.
- **`Disconnect` no borra nada.** Ni archivos, ni sesiones en ejecución en el host.
- **Los tiempos de espera del auxiliar** (tiempo de inactividad, intentos) son decisiones de
  implementación y pueden cambiar entre releases.
- **Plataformas del host.** El auxiliar de Elyra tiene builds para Windows, macOS y Linux.
- **Las credenciales no aparecen en esta documentación** — ni claves, ni contraseñas, ni nombres de
  máquinas reales.

## Cuando no conecta

1. **Lea el mensaje de error completo.** Clasifica el motivo más común — por ejemplo, una clave protegida
   por contraseña que nadie informó. Cuando la app no reconoce el motivo, muestra el texto original, sin
   traducir, justamente para que usted pueda buscarlo o pegarlo en un reporte.
2. **Compruebe que su SSH funciona fuera de la app.** Ejecute el mismo destino en la terminal del sistema.
   Si falla allí, el problema es la conexión, no Elyra.
3. **Si el error menciona una versión de auxiliar**, el auxiliar instalado en el host y la app vienen de
   builds diferentes. Reconectar lo resuelve; el host instala la versión nueva.
4. **Si el host quedó a mitad de una instalación**, una conexión lenta justo después de un reinicio suele
   ser un bloqueo de instalación huérfano. Esperar a que el bloqueo expire e intentar de nuevo es el
   camino.

## Próximos pasos

- [Abrir un proyecto en otra máquina](/docs/es/sistema/ssh-projeto-remoto/)