---
id: "cloud.operar-pela-cli"
titulo: "Operar o seu Cloud"
resumo: "Acompanhar, desligar e religar o Cloud: pelo app no Windows, no macOS e no Linux com tela, e pela CLI no servidor Linux sem tela."
idioma: "pt-br"
tipo: "referencia"
categoria: "cloud"
aplicavelDesde: "0.0.16"
capabilities: ["cloud.cli"]
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/operar-pela-cli/"
fonte: "pt-br/cloud/operar-pela-cli.md"
caminhoPublico: "docs/publica/pt-br/cloud/operar-pela-cli.md"
hashFonte: "sha256:e4a9aab2ebd93617db755991e04e0824ac176d18cc6f7a1d664c9a6d3d5b2599"
hashDestaPagina: "sha256:e4a9aab2ebd93617db755991e04e0824ac176d18cc6f7a1d664c9a6d3d5b2599"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Como você acompanha o Cloud depende de onde ele foi ligado.

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

Tudo fica em **Ajustes → Elyra Cloud**, no cartão **Tornar este computador o seu Cloud**:

| O cartão mostra | O que significa |
|---|---|
| **Ligando…** | O Cloud está subindo e pedindo o endereço à conta. |
| **No ar desde** HH:MM | O Cloud está no ar. **Copiar** copia o endereço; **Abrir** abre no navegador. |
| **Reconectando…** | A conexão com o endereço caiu e está voltando sozinha. |
| **Desligado** | O Cloud não está ligado neste computador. |

- **Desligar**: toque em **Desativar** e confirme. Quem estiver conectado pelo endereço perde a conexão.
- **Religar**: toque em **Ativar** de novo.
- **Sair do Elyra** também desliga o Cloud. Ao abrir o app de novo, confira o cartão: se estiver **Desligado**, toque em **Ativar**.

## Num servidor Linux sem tela

No servidor, o Elyra Cloud roda como o serviço de usuário `elyra-cloud.service`. Você o acompanha pela CLI
`elyra cloud` e pelo `systemctl`.

### `elyra cloud status`

```
elyra cloud status [--json]
```

Mostra se o servidor está pronto. Sai com erro quando não consegue alcançá-lo. Se o servidor subiu numa
porta diferente da preferida (a 6768 estava ocupada), o comando avisa a porta real.

### `elyra cloud stop`

```
elyra cloud stop [--json]
```

Para o Elyra Cloud neste computador. Quando ele roda como serviço, o comando para o serviço; o serviço
continua habilitado e volta quando a máquina reiniciar ou quando você iniciá-lo de novo. Ao parar, o
servidor também solta o endereço na conta. O comando só diz "foi parado" depois de confirmar a parada, e
sai com erro se não conseguiu:

- `não está rodando`: nada a parar.
- `não deu para confirmar`: confira com `elyra cloud status` e rode de novo.

### `elyra cloud start`

```
elyra cloud start [--json]
```

Sobe o servidor **em primeiro plano**, no terminal (Ctrl+C ou `elyra cloud stop` param). Em geral você não
precisa dele: o serviço já faz isso. Se o Cloud já estiver rodando, o comando diz isso e não inicia outro.

### `elyra cloud desinstalar`

```
elyra cloud desinstalar [--sim] [--json]
```

Remove o Cloud instalado nesta máquina. Está em [Desligar ou desinstalar](/docs/pt-br/cloud/desinstalar/).

### O serviço pelo `systemctl`

```
systemctl --user status elyra-cloud.service     # estado
systemctl --user restart elyra-cloud.service    # reiniciar (gera um código novo se ainda não ativado)
systemctl --user stop elyra-cloud.service       # parar
systemctl --user start elyra-cloud.service      # iniciar
```

### Ver o log

```
journalctl --user -t elyra-cloud -f
```

Mostra o que o serviço escreve, ao vivo: o código de ativação, o endereço e os erros.

### O serviço volta sozinho

- Depois de **reiniciar a máquina**: o serviço está habilitado, e o **linger** do usuário faz o systemd
  dele subir sem precisar de login.
- Depois de **uma falha**: o systemd tenta de novo a cada 30 segundos. Erros que não adianta repetir (como
  uma ativação recusada) param o serviço, e o motivo fica no log.

## Próximos passos

- [Resolver problemas](/docs/pt-br/cloud/resolver-problemas/)
- [Desligar ou desinstalar](/docs/pt-br/cloud/desinstalar/)