Concepts
Environments

Environments

An Environment is a logical grouping of deployments. Environments allow you to organize deployments while maintaining flexibility in isolation levels.

What is an Environment?

Each organization has one default environment. All deployments belong to this environment.

Flexible Isolation Across Environments

Different Onvera environments can use different isolation levels:

  • Shared infrastructure - Cost-effective for staging or development
  • Dedicated infrastructure - Stronger isolation for production workloads
  • Dedicated networking - Network-level isolation for compliance
  • BYOC (Bring Your Own Cloud) - Complete control in your own cloud account

Example: You can have separate Onvera environments—staging on shared infrastructure, development on dedicated infrastructure, and production on BYOC—all managed through the same Onvera control plane with consistent operational workflows.

Default Environment

The default environment:

  • Has ID: env_default
  • Has name: Default
  • Is system-owned (cannot be created, modified, or deleted)
  • Contains all deployments in the organization

Listing Environments

List environments using the API:

curl -H "X-API-Key: onv_sk_live_..." \
  https://api.onvera.io/api/v1/environments

Response:

{
  "data": {
    "items": [
      {
        "id": "env_default",
        "name": "Default",
        "slug": "default",
        "created_at": "2024-01-20T12:00:00Z"
      }
    ]
  }
}

Environment Properties

Each environment has:

  • ID - Unique identifier
  • Name - Human-readable name
  • Slug - URL-friendly identifier
  • Created At - Timestamp when environment was created

Related Concepts

OverviewDeployments