---
id: "cloud.resolver-problemas"
titulo: "Resolver problemas"
resumo: "O que fazer quando o endereço não abre, o Cloud não liga pelo app, o código expira ou o serviço não sobe."
idioma: "pt-br"
tipo: "guia"
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/resolver-problemas/"
fonte: "pt-br/cloud/resolver-problemas.md"
caminhoPublico: "docs/publica/pt-br/cloud/resolver-problemas.md"
hashFonte: "sha256:675e838202fd7c4d0dc99e02fc0ad0dc6200bf2ee5c2aa131889865805e4a161"
hashDestaPagina: "sha256:675e838202fd7c4d0dc99e02fc0ad0dc6200bf2ee5c2aa131889865805e4a161"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## Nos dois caminhos

### O endereço mostra o erro 1033

Logo depois que o Cloud liga, o endereço público leva alguns instantes para começar a responder, e a
página de erro 1033 pode aparecer nesse intervalo. Espere alguns instantes e recarregue. Se persistir,
confira se o Cloud está **No ar** (no app) ou ativado (`elyra cloud status`, no servidor).

### Pede para entrar de novo

A sessão vale 15 minutos e só se renova com o Cloud no ar. Se ele ficou desligado ou sem internet por mais
tempo que isso, a sessão venceu: entre de novo com a conta. Reiniciar, sozinho, não derruba ninguém.

## No Windows, no macOS e no Linux com tela

Os avisos aparecem em **Ajustes → Elyra Cloud**, no cartão **Tornar este computador o seu Cloud**.

| O que aparece | O que fazer |
|---|---|
| "ative a licença deste computador primeiro" | Ative o Elyra com a sua conta e tente de novo. |
| "escolha um nome de usuário na sua conta Elyra" | Escolha o nome em `app.elyra.sh/conta` e tente de novo. |
| "desligue o pareamento do celular pela rede local" | Desligue o pareamento do celular e toque em **Ativar**. |
| "a porta do Elyra Cloud está ocupada neste computador" | Feche o programa que usa a porta, ou reinicie o computador, e tente de novo. |
| "a conta Elyra recusou o pedido" | Atualize o Elyra e tente de novo. Se continuar, fale com o suporte. |
| "O endereço público do Cloud não ficou disponível" | Confira a internet deste computador, toque em **Desativar** e depois em **Ativar**. |
| "A conexão do Cloud caiu e não voltou" | Toque em **Desativar** e depois em **Ativar**. |
| "Outro computador passou a ser o Cloud desta conta" | O Cloud foi ligado em outro computador. Para trazê-lo de volta, toque em **Ativar** aqui. |
| "O Elyra não conseguiu voltar ao modo normal" | Reinicie o Elyra antes de ativar de novo. |

Ao usar o Cloud **por outro Elyra** (**Usar o Cloud de outro computador**):

| O que aparece | O que fazer |
|---|---|
| "Cloud offline" | Ligue o computador que é o Cloud e toque em **Verificar de novo**. |
| "esta conta ainda não tem um Elyra Cloud" | Ligue o Cloud em algum computador primeiro: [Ligar o seu Cloud](/docs/pt-br/cloud/tornar-este-computador/). |
| "O computador que serve o Cloud está com uma versão antiga do Elyra" | Atualize o Elyra no computador que é o Cloud. |
| "a sessão acabou" | Toque em **Conectar** de novo. |

## Num servidor Linux sem tela

Comece sempre pelo estado e pelo log:

```
systemctl --user status elyra-cloud.service
journalctl --user -t elyra-cloud -f
elyra cloud status
```

### O código de ativação expirou

O servidor gera outro código sozinho a cada vencimento. Veja o atual no log, ou reinicie o serviço para
gerar um novo, e aprove sempre o último. Passo a passo em [Ativar o servidor](/docs/pt-br/cloud/ativar/#o-código-expira).

### A licença não tem aparelho livre

O terminal lista os aparelhos em uso. Libere um em `app.elyra.sh/conta` (Aparelhos); o servidor tenta de
novo sozinho, com espera crescente, e mostra um código novo para você aprovar.

### Licença vencida, revogada ou ausente

O servidor não abre o acesso e diz o motivo no log: renove ou assine em `app.elyra.sh`. Resolvido, reinicie
o serviço. Esses erros **param o serviço** em vez de repetir, para não sobrecarregar a conta.

### O serviço não sobe

1. Veja o motivo: `systemctl --user status elyra-cloud.service` e o log.
2. **Porta ocupada**: se o log indica uma porta em uso, encerre o outro processo e reinicie o serviço.
3. **Sem contato com a conta**: o servidor tenta de novo sozinho. Confira a internet da máquina.
4. Resolvido o motivo, `systemctl --user restart elyra-cloud.service`.

### O serviço não volta depois de reiniciar a máquina (linger)

O serviço de usuário só roda sem sessão aberta se o **linger** do usuário estiver ligado. Confira:

```
loginctl show-user "$USER" -p Linger
```

Se aparecer `Linger=no`, ligue com `sudo loginctl enable-linger "$USER"` ou rode o instalador de novo, que
liga o linger quando precisa.

Se o instalador disser que o systemd do usuário não iniciou, entre por SSH **diretamente como esse
usuário** (não por `su` nem `sudo -u`) e rode o instalador de novo.

### O instalador diz que não tem root nem sudo

Ele precisa de privilégio para instalar o pacote e escrever a regra de `sudo` do
[desinstalador](/docs/pt-br/cloud/desinstalar/). Rode como root, ou num terminal onde o `sudo` consiga pedir a sua
senha, ou num usuário com `sudo` sem senha.

### O instalador recusa a máquina

Ele suporta Ubuntu 20.04+ e Debian 11+, em x64 ou arm64, com systemd. Outra distribuição, versão ou
arquitetura é recusada antes de qualquer alteração.

### Reinstalar do zero

1. `elyra cloud desinstalar` (veja [Desinstalar](/docs/pt-br/cloud/desinstalar/)).
2. Rode o instalador de novo e ative com um código novo.

Se só quer corrigir uma instalação com problema, basta **rodar o instalador de novo**: ele é seguro de
repetir e conserta o que faltar.

## Próximos passos

- [Operar pela CLI](/docs/pt-br/cloud/operar-pela-cli/)
- [Instalar o Elyra Cloud](/docs/pt-br/cloud/instalar/)