---
id: "cloud.instalar"
titulo: "Instalar en un servidor Linux"
resumo: "Para una máquina Linux sin pantalla: un comando instala Elyra como servicio y deja el servidor listo para activar."
idioma: "es"
tipo: "tutorial"
categoria: "cloud"
aplicavelDesde: "0.0.16"
capabilities: []
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "e593bd0591d172fd8fb2c40f2c38f5bb52980eb3"
revisaoFonte: "2026-10-04"
revisor: "mantenedor (autorizou a publicação, 2026-10-04)"
rota: "/docs/es/cloud/instalar/"
fonte: "pt-br/cloud/instalar.md"
caminhoPublico: "docs/publica/es/cloud/instalar.md"
hashFonte: "sha256:08f9c7faa3203311b2a382e175fb7bb4826056376e2be82890eecab17318e0b3"
hashDestaPagina: "sha256:09534d24e18edb845d0ab973a0d6a574299ec6cda803420c00271d4c1955afd3"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/cloud/instalar.md fonteHash=sha256:08f9c7faa3203311b2a382e175fb7bb4826056376e2be82890eecab17318e0b3 estado=atual -->

Este camino es para una **máquina Linux sin pantalla**, como un servidor en la nube al que se accede por SSH. En un equipo
con pantalla, en Windows, macOS o Linux, lo más sencillo es
[activar el Cloud desde la app](/docs/es/cloud/tornar-este-computador/).

La instalación es un **único comando**, ejecutado en el terminal del servidor.

## Antes de empezar

- Una máquina **Linux con systemd**: Ubuntu 20.04 o más reciente, o Debian 11 o más reciente, en **x64 o
  arm64**.
- Acceso a ella por terminal, como **root** o como un usuario normal con **sudo**.
- Internet de salida. No hace falta abrir puertos ni configurar DNS.
- Los requisitos de la cuenta están en la [visión general](/docs/es/cloud/visao-geral/#qué-necesitas).
- Ejecútalo como el **usuario que mantendrá el servicio**. El instalador crea un servicio de ese usuario,
  no de todo el sistema.
- Sin ser root y sin `sudo`, el instalador se detiene antes de descargar nada y lo dice.

## Ejecutar el instalador

```
curl -fsSL https://app.elyra.sh/cloud/instalar.sh | sh
```

Cada etapa aparece en una línea con su estado. Al final, el instalador espera a que el servidor arranque y
muestra el **código de activación**: continúa en [Activar el servidor](/docs/es/cloud/ativar/).

### Elegir cómo activar

En un terminal interactivo, la activación empieza con la pregunta **"Como deseja entrar?"** ("¿Cómo deseas
entrar?"). Elige con las flechas (o escribe `1` o `2`) y confirma con Enter:

- **Entrar pelo link** (entrar por el enlace): abre el navegador cuando hay entorno gráfico; si no,
  muestra la dirección para que la abras.
- **Usar QR Code** (usar un código QR): muestra el QR en el terminal para apuntar la cámara del móvil.

Para saltarte la pregunta, usa la forma directa:

```
curl -fsSL https://app.elyra.sh/cloud/instalar.sh | sh -s -- --link
curl -fsSL https://app.elyra.sh/cloud/instalar.sh | sh -s -- --qr
```

Sin terminal donde preguntar, la activación sigue por el enlace. `--help` muestra el resumen de las
opciones, y cualquier otro argumento se rechaza.

### Idioma

El instalador habla portugués, inglés y español. Sigue el idioma del sistema (`LC_ALL`, `LC_MESSAGES` o
`LANG`, en ese orden): el portugués y el español se reconocen, y cualquier otro, incluidos `C` y `POSIX`,
queda en inglés. Para elegir, usa `--lang`:

```
curl -fsSL https://app.elyra.sh/cloud/instalar.sh | sh -s -- --lang es
curl -fsSL https://app.elyra.sh/cloud/instalar.sh | sh -s -- --lang en --link
```

`--lang` acepta `pt-br`, `en` y `es`, y también formas como `pt`, `pt_BR`, `en-US` y `es-419`. Tiene
prioridad sobre el idioma del sistema y se combina con `--link`, `--qr` y `--help`.

## Qué hace el instalador

1. Comprueba la distribución y la arquitectura, y rechaza las que no admite.
2. Descarga el paquete de Elyra para Linux y comprueba la **suma de verificación (SHA-256)** antes de
   instalar. Prefiere el paquete `.deb`; cuando no está disponible, usa un **AppImage** de respaldo,
   guardado en la carpeta de datos de tu usuario.
3. Instala las bibliotecas que Elyra necesita y que aún faltan, más `xvfb` (pantalla virtual). Después
   permanecen en el sistema, porque otros programas pueden usarlas.
4. Crea y habilita el **servicio de usuario** `elyra-cloud.service`, que vuelve solo tras reiniciar la
   máquina.
5. Activa el **linger** del usuario, si estaba desactivado, para que el servicio se ejecute incluso sin
   ninguna sesión abierta. Si ya estaba activado, no lo toca.
6. Escribe una regla de `sudo` sin contraseña, mínima, en `/etc/sudoers.d/elyra-cloud-<usuario>`. Permite que tu
   usuario ejecute, como root y sin contraseña, solo cuatro comandos: activar el linger, desactivarlo,
   `dpkg -r elyra` y borrar ese mismo archivo. Son los que necesita el
   [desinstalador](/docs/es/cloud/desinstalar/), que quita la regla al final.
7. Guarda un **inventario** de lo que instaló en el perfil de Cloud, para que la
   [desinstalación](/docs/es/cloud/desinstalar/) deshaga solo lo que es de Elyra.
8. Inicia el servicio y sigue el arranque para mostrar el código de activación.

## Ejecutarlo de nuevo es seguro

El instalador es **idempotente**: ejecutarlo dos veces da el mismo resultado que ejecutarlo una.

- Servicio, regla de `sudo` y archivos idénticos no se reescriben.
- Con el paquete ya instalado, **actualiza** cuando hay una versión más nueva y nunca vuelve a una más
  antigua.
- Lo que ya existía en la máquina antes (un paquete, el linger) nunca se toma como suyo ni se quita
  después.
- Un archivo que el instalador no reconoce como suyo no se sobrescribe: se detiene, avisa y no cambia nada.

Si algo falla a mitad de camino, el instalador deshace lo que hizo en esa ejecución y muestra las últimas
líneas de lo ejecutado y dónde está el registro completo.

## Próximos pasos

- [Activar el servidor](/docs/es/cloud/ativar/)
- [Resolver problemas](/docs/es/cloud/resolver-problemas/)