---
id: "cloud.instalar"
titulo: "Instalar num servidor Linux"
resumo: "Para uma máquina Linux sem tela: um comando instala o Elyra como serviço e deixa o servidor pronto para ativar."
idioma: "pt-br"
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/pt-br/cloud/instalar/"
fonte: "pt-br/cloud/instalar.md"
caminhoPublico: "docs/publica/pt-br/cloud/instalar.md"
hashFonte: "sha256:08f9c7faa3203311b2a382e175fb7bb4826056376e2be82890eecab17318e0b3"
hashDestaPagina: "sha256:08f9c7faa3203311b2a382e175fb7bb4826056376e2be82890eecab17318e0b3"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Este caminho é para uma **máquina Linux sem tela**, como um servidor na nuvem acessado por SSH. Num computador
com tela, em Windows, macOS ou Linux, o jeito mais simples é
[ligar o Cloud pelo app](/docs/pt-br/cloud/tornar-este-computador/).

A instalação é um **único comando**, rodado no terminal do servidor.

## Antes de começar

- Uma máquina **Linux com systemd**: Ubuntu 20.04 ou mais novo, ou Debian 11 ou mais novo, em **x64 ou
  arm64**.
- Acesso a ela pelo terminal, como **root** ou como um usuário comum com **sudo**.
- Internet de saída. Não é preciso abrir porta nem configurar DNS.
- Os requisitos da conta estão na [visão geral](/docs/pt-br/cloud/visao-geral/#o-que-você-precisa).
- Rode como o **usuário que vai manter o serviço**. O instalador cria um serviço desse usuário, não do
  sistema todo.
- Sem ser root e sem `sudo`, o instalador para antes de baixar qualquer coisa e diz isso.

## Rodar o instalador

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

Cada etapa aparece numa linha com o status. Ao final, o instalador espera o servidor subir e mostra o
**código de ativação**: siga em [Ativar o servidor](/docs/pt-br/cloud/ativar/).

### Escolher como ativar

Em terminal interativo, a ativação começa com a pergunta **"Como deseja entrar?"**. Escolha com as setas
(ou digite `1` ou `2`) e confirme com Enter:

- **Entrar pelo link**: abre o navegador quando há ambiente gráfico; senão, mostra o endereço para você
  abrir.
- **Usar QR Code**: mostra o QR no terminal, para apontar a câmera do celular.

Para pular a pergunta, use a forma direta:

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

Sem terminal para perguntar, a ativação segue pelo link. `--help` mostra o resumo das opções, e qualquer
outro argumento é recusado.

### Idioma

O instalador fala português, inglês e espanhol. Ele segue o idioma do sistema (`LC_ALL`, `LC_MESSAGES` ou
`LANG`, nessa ordem): português e espanhol são reconhecidos, e qualquer outro, inclusive `C` e `POSIX`, fica
em inglês. Para escolher, use `--lang`:

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

`--lang` aceita `pt-br`, `en` e `es`, e também formas como `pt`, `pt_BR`, `en-US` e `es-419`. Ele vale
mais que o idioma do sistema e combina com `--link`, `--qr` e `--help`.

## O que o instalador faz

1. Confere a distribuição e a arquitetura, e recusa as que não suporta.
2. Baixa o pacote do Elyra para Linux e confere a **soma de verificação (SHA-256)** antes de instalar.
   Prefere o pacote `.deb`; quando ele não está disponível, usa um **AppImage** de reserva, guardado na
   pasta de dados do seu usuário.
3. Instala as bibliotecas que o Elyra precisa e que ainda faltam, mais o `xvfb` (tela virtual). Elas
   permanecem no sistema depois, porque outros programas podem usá-las.
4. Cria e habilita o **serviço de usuário** `elyra-cloud.service`, que volta sozinho depois de reiniciar a
   máquina.
5. Liga o **linger** do usuário, se estava desligado, para o serviço rodar mesmo sem nenhuma sessão
   aberta. Se já estava ligado, não mexe.
6. Escreve uma regra de `sudo` sem senha, mínima, em `/etc/sudoers.d/elyra-cloud-<usuário>`. Ela permite que o seu
   usuário rode, como root e sem senha, só quatro comandos: ligar o linger, desligar o linger, `dpkg -r
   elyra` e apagar esse próprio arquivo. São os que o desinstalador precisa; o
   [desinstalador](/docs/pt-br/cloud/desinstalar/) remove a regra por último.
7. Grava um **inventário** do que instalou no perfil do Cloud, para a [desinstalação](/docs/pt-br/cloud/desinstalar/)
   desfazer só o que é do Elyra.
8. Inicia o serviço e acompanha o início para mostrar o código de ativação.

## Rodar de novo é seguro

O instalador é **idempotente**: rodar duas vezes dá o mesmo resultado que rodar uma.

- Serviço, regra de `sudo` e arquivos iguais não são reescritos.
- Com o pacote já instalado, ele **atualiza** quando há versão mais nova e nunca volta para uma mais
  antiga.
- O que já existia na máquina antes (um pacote, o linger) nunca é tomado como dele nem removido depois.
- Arquivo que o instalador não reconhece como dele não é sobrescrito: ele para, avisa e não altera nada.

Se algo falhar no meio, o instalador desfaz o que fez naquela execução e mostra as últimas linhas do que
rodou e onde está o registro completo.

## Próximos passos

- [Ativar o servidor](/docs/pt-br/cloud/ativar/)
- [Resolver problemas](/docs/pt-br/cloud/resolver-problemas/)