---
id: "sistema.ambientes-de-execucao"
titulo: "Onde o seu código roda"
resumo: "Entenda as três opções de destino — esta máquina, um host SSH e um ambiente remoto salvo."
idioma: "pt-br"
tipo: "conceito"
categoria: "ambientes"
aplicavelDesde: "0.0.16"
capabilities: ["environment.ssh.hosts", "environment.runtime.inspect"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/sistema/ambientes-de-execucao/"
fonte: "pt-br/sistema/ambientes-de-execucao.md"
caminhoPublico: "docs/publica/pt-br/sistema/ambientes-de-execucao.md"
hashFonte: "sha256:76aae891b28acd322f86d59835d0c3d0f7feb57c97f7621ebe68669205b89982"
hashDestaPagina: "sha256:76aae891b28acd322f86d59835d0c3d0f7feb57c97f7621ebe68669205b89982"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
O Elyra é local por padrão: o app roda na sua máquina. Mas **onde o trabalho acontece** é uma escolha
separada. Esta página explica as três opções de destino para que você escolha a certa antes de criar um
projeto ou um workspace.

## Projeto e workspace são coisas diferentes

- **Projeto** é o repositório ou a pasta de trabalho. É o que você abre e onde vive o Git.
- **Workspace** é uma unidade de trabalho dentro do projeto. Vários workspaces podem apontar para a mesma
  pasta ou para pastas diferentes.

Essa distinção importa aqui porque **o destino é escolhido no workspace** (e, em parte, na criação do
projeto). Trocar de destino não é trocar de projeto.

## As três opções

| Destino | Onde o código roda | Quando faz sentido |
|---|---|---|
| **Esta máquina** | No seu computador | O caso comum. Nada a configurar. |
| **Host SSH** | Numa máquina que você acessa pela rede | O projeto mora num servidor, numa VPS ou na máquina de outra pessoa |
| **Ambiente remoto salvo** | Num runtime do Elyra que você já registrou | Você já tem um ambiente cadastrado e quer selecioná-lo por nome |

### Esta máquina

É o padrão. O projeto é uma pasta local, o terminal roda local e o Git roda local. Nada é enviado para
fora.

### Host SSH

Você cadastra um host e passa a abrir projeto, workspace e terminal **na máquina remota**. O projeto não é
copiado para o seu computador: o app aponta para uma pasta que existe do outro lado. O cadastro do host
tem página própria — veja [Hosts SSH](/docs/pt-br/sistema/ssh-hosts/) — e o caminho de criação de projeto remoto está em
[Abrir um projeto em outra máquina](/docs/pt-br/sistema/ssh-projeto-remoto/).

### Ambiente remoto salvo

Um **ambiente remoto** é um runtime do Elyra registrado no seu perfil local. Ele aparece nas listas do
app e nos seletores dos comandos de CLI, e pode ser consultado por nome.

Duas coisas importantes:

- **Um ambiente salvo não é um servidor disponível.** O registro local diz que você apontou o app para
  aquele ambiente; ele não diz que a outra ponta está no ar.
- **Ambiente é do cliente, não do projeto.** Esquecer um ambiente mexe apenas no seu perfil local.

## Como escolher

1. **O projeto já está no seu computador?** Fique em **Esta máquina**.
2. **O projeto precisa da máquina de outra pessoa ou de um servidor?** Cadastre o host e abra o projeto
   por SSH.
3. **Você já registrou um ambiente remoto?** Confira o que está salvo antes de usá-lo — um registro pode
   estar apontando para algo que não responde mais.

## Limites

- **O destino não copia arquivos.** Escolher um host remoto registra um caminho remoto; ele não traz o
  projeto para o seu computador.
- **O ambiente remoto depende da outra ponta.** Disponibilidade, versão e permissões do lado remoto não
  são garantidas pelo app.

## Próximos passos

- [Hosts SSH](/docs/pt-br/sistema/ssh-hosts/)
- [Abrir um projeto em outra máquina](/docs/pt-br/sistema/ssh-projeto-remoto/)