> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate from Gitpod Classic to Ona

> Convert your Gitpod Classic .gitpod.yml to Ona Dev Container and Tasks configuration.

Ona uses [Dev Containers](/docs/ona/configuration/devcontainer/overview) and [Tasks and Services](/docs/ona/configuration/tasks-and-services/overview) as its core configuration elements. Migration involves converting your `.gitpod.yml` into a `devcontainer.json` and `automations.yaml` setup.

## Migrate the configuration

Create a new Ona environment for your existing repository and run the migration command:

```bash theme={null}
ona env migrate
```

This command generates two key files:

* `.devcontainer/devcontainer.json`: Defines your development environment by setting the workspace folder, image, user, and other settings, aligned with Gitpod Classic experience.
* `.ona/automations.yaml`: Contains tasks extracted from `.gitpod.yml`, maintaining their dependency order.

## Test the configuration

1. Deploy the `automations.yaml` file:

   ```bash theme={null}
   ona automations update .ona/automations.yaml
   ```

2. Rebuild your environment with the new devcontainer.json:

   ```bash theme={null}
   ona environment devcontainer rebuild
   ```

3. The default workspace folder in Dev Container differs from Gitpod Classic (`/workspaces` vs `/workspace`). VS Code may not open the correct folder automatically after rebuilding. Use the "Open File" option in VS Code to select the `/workspace/<project>` folder.

## Customize the configuration

While `ona env migrate` creates these baseline files, you need to make manual adjustments to match your requirements.
The default Dev Container image differs from the Gitpod Classic workspace image. Create a custom image to match your previous setup.

Refer to the following resources to learn more about the configuration options:

* [Dev Containers](/docs/ona/configuration/devcontainer/overview)
* [Tasks and Services](/docs/ona/configuration/tasks-and-services/overview)