> ## 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.

# Development environments

> Isolated development workspaces for humans and agents.

Ona environments are isolated development workspaces for humans and agents. Each environment combines compute, storage, your repository, and your development tooling into a reproducible setup.

## Key concepts

* **[Projects](https://ona.com/docs/ona/create-first-project.md)**: connect a repository to Ona with shared configuration, access controls, and secrets.
* **Environments**: running workspaces for development, review, debugging, or focused tasks.
* **[Codex Agent](https://ona.com/docs/ona/agents/codex.md)**: works inside environments with the same tools a developer would use.
* **[Automations](https://ona.com/docs/ona/automations/overview.md)**: create environments on triggers like PRs, schedules, or webhooks.

## What's inside an environment

| Component | Description |
| - | - |
| Compute | From your own [runner](https://ona.com/docs/ona/runners/overview.md) |
| Dev Container | Image, tools, extensions, and workspace setup. See [Container configuration](https://ona.com/docs/ona/configuration/devcontainer/overview.md) |
| Tasks & services | Databases, servers, watchers. See [Startup tasks & services](https://ona.com/docs/ona/configuration/tasks-and-services/overview.md) |
| Dotfiles | Personal shell and editor customization. See [Dotfiles](https://ona.com/docs/ona/configuration/dotfiles/overview.md) |
| Editor access | Browser, VS Code, Cursor, JetBrains, CLI, or SSH. See [Editors](https://ona.com/docs/ona/editors/overview.md) |

## Lifecycle

* **Create**: start an environment from a project — choose a branch and environment class.
* **Provision**: Ona sets up compute, starts your Dev Container, and runs setup hooks.
* **Work**: you or an agent connect and start developing.
* **Stop**: storage persists so you can resume later.
* **Archive**: after inactivity, Ona [archives and can auto-delete](https://ona.com/docs/ona/environments/archive-auto-delete.md) the environment.

## Storage and isolation

Environments are isolated from each other. Storage persists across stops and starts of the same environment. Creating a new environment starts fresh from the project configuration and any available prebuild.

See [Persistent storage](https://ona.com/docs/ona/environments/persistent-storage.md) for what survives Dev Container rebuilds and how prebuilds interact with storage. To share a running service, use [port sharing](https://ona.com/docs/ona/integrations/ports.md).

## Faster starts

[Prebuilds](https://ona.com/docs/ona/projects/prebuilds.md) snapshot your Dev Container setup so new environments skip slow installation steps. On supported AWS runners, [warm pools](https://ona.com/docs/ona/projects/warm-pools.md) keep pre-initialized instances ready.

## Configuration

* **[Container configuration](https://ona.com/docs/ona/configuration/devcontainer/overview.md)**: image, tools, mounts, editor customizations
* **[Startup tasks & services](https://ona.com/docs/ona/configuration/tasks-and-services/overview.md)**: long-running processes and one-off tasks
* **[Dotfiles](https://ona.com/docs/ona/configuration/dotfiles/overview.md)**: personal shell and editor setup
* **[Multi-repository environments](https://ona.com/docs/ona/configuration/multi-repository.md)**: work across multiple repos

New to Ona? Start with [Set up your first environment](https://ona.com/docs/ona/configuration/devcontainer/getting-started.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.