---
id: "sistema.ambientes-de-execucao"
titulo: "Where your code runs"
resumo: "Understand the three destinations — this machine, an SSH host and a saved remote environment."
idioma: "en"
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/en/sistema/ambientes-de-execucao/"
fonte: "pt-br/sistema/ambientes-de-execucao.md"
caminhoPublico: "docs/publica/en/sistema/ambientes-de-execucao.md"
hashFonte: "sha256:76aae891b28acd322f86d59835d0c3d0f7feb57c97f7621ebe68669205b89982"
hashDestaPagina: "sha256:ce9796844d2bd1876855333a46695cbff4e444960ffb533c965aaa5bb2b3b98c"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=EN fonte=pt-br/sistema/ambientes-de-execucao.md fonteHash=sha256:76aae891b28acd322f86d59835d0c3d0f7feb57c97f7621ebe68669205b89982 estado=atual -->

Elyra is local by default: the app runs on your machine. But **where the work happens** is a separate
choice. This page explains the three destination options so you pick the right one before creating a
project or a workspace.

## Project and workspace are different things

- A **project** is the repository or the working folder. It is what you open, and where Git lives.
- A **workspace** is a unit of work inside the project. Several workspaces can point at the same folder or
  at different folders.

That distinction matters here because **the destination is chosen on the workspace** (and partly when the
project is created). Changing destination is not changing project.

## The three options

| Destination | Where the code runs | When it makes sense |
|---|---|---|
| **This machine** | On your computer | The common case. Nothing to configure. |
| **SSH host** | On a machine you reach over the network | The project lives on a server, a VPS or someone else's machine |
| **Saved remote environment** | On an Elyra runtime you already registered | You already have an environment registered and want to select it by name |

### This machine

This is the default. The project is a local folder, the terminal runs locally and Git runs locally.
Nothing is sent anywhere.

### SSH host

You register a host and start opening project, workspace and terminal **on the remote machine**. The
project is not copied to your computer: the app points at a folder that exists on the other side.
Registering the host has its own page — see [SSH hosts](/docs/en/sistema/ssh-hosts/) — and the remote project creation
path is in [Open a project on another machine](/docs/en/sistema/ssh-projeto-remoto/).

### Saved remote environment

A **remote environment** is an Elyra runtime registered in your local profile. It appears in the app's
lists and in the command-line selectors, and can be queried by name.

Two important things:

- **A saved environment is not an available server.** The local registration says you pointed the app at
  that environment; it does not say the other side is up.
- **An environment belongs to the client, not the project.** Forgetting an environment only touches your
  local profile.

## How to choose

1. **Is the project already on your computer?** Stay on **This machine**.
2. **Does the project need someone else's machine or a server?** Register the host and open the project
   over SSH.
3. **Have you already registered a remote environment?** Check what is saved before using it — a
   registration may be pointing at something that no longer answers.

## Limits

- **The destination does not copy files.** Choosing a remote host registers a remote path; it does not
  bring the project to your computer.
- **The remote environment depends on the other side.** Availability, version and permissions on the
  remote side are not guaranteed by the app.

## Next steps

- [SSH hosts](/docs/en/sistema/ssh-hosts/)
- [Open a project on another machine](/docs/en/sistema/ssh-projeto-remoto/)